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138 SEND SUPERVISOR REQUEST 

153 SET CELL 21 1B 

153 RESET CELL 21 1B 

MISCELLANEOUS 

7 READ TABLES 

131 CRASH SYSTEM 

136 SET EXEC SWITCHES 

141 GET EXEC SUBROUTINES 

144 GET A BUFFER 

145 RETURN A BUFFER 

97 RESET SUBSYSTEM COUNTER 

9 8 INCREMENT SUBSYSTEM COUNTER 

99 READ SUBSYSTEM COUNTER 

55 DISMISS IF JOB USING DISC 
61 CHANGE TELETYPE WORKING SET 
93 RESET RESOURCE METERING 

146 READ QUEUE COUNTERS 
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SECTION 3.0 BRS'S IN NUMERICAL SEQUENCE 

*BRS 1* 

Date: 71/09/03 
Name: [open] [file] 
Status : Exec 

Input: A= [File Directory Pointer Address] 
B= Privilege bits for random files 
Output : 

Skip Return: A= File number 
(success) B= Same as input 

X= Index block pointer 

Return: A= Disc address 
(failure) B= Same as input 
X= Error number 

Description: Opens a file with the index block pointer in A. If the 
file cannot be opened for any one of the reasons listed below, a non- 
skip return is taken and the error number returned in the X register. 
If a file is opened for output any other attempts to open that file 
will result in "FILE BUSY". 

Privilege bits in X: 

Bit 18 (40B) = User can do SCP syspop 

19 (20B) = 

20 (10B) = 

21 ( 4B) = User may do PCE syspop 

22 ( 2B) = Set to write mode 

23 ( 1B) = Set to read mode 

Error numbers in X: 

1 = File busy 

2 = All buffers busy 

3 = Bitmap not set 

4 = [Fatal exception] for disc error 

5 = Disc full or out of file numbers 

Instruction traps: insufficient status 
♦BRS 2* 

Date: 71/09/0 3 

Name: [close] [file] 

Status: Exec 

Input: A= File number returned by BRS 1 

Output: A= Same as input 

B= Same as input 

X= Sane as input 
Description: Closes file opened by BRS 1. 
Instruction traps: Insufficient status, bad file number. 

♦BRS 3* 
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Date: 71/09/03 

Name: Make [indirect pointer] 

Status: User, subsystem, system or Exec (depending on operation) 

Input: A= [relabeling] byte or [subsystem byte number] (expanded SMT) 

X= Port number (only used if 43B A 100B) 
Output: A= Relabeling byte 

B= Same as input 

X= Same as input 
Description: This BRS has several functions. They are: 



1. To set up a pointer to an SMT (byte 43B) 

2. To set up a pointer to a PMT in channel number in X (44B byte 

3. To set up a pointer to an [expanded SMT] (100B byte 21 5B) 



100B) 



If the sign bit is on, the byte will be made read only. 
The BRS 3 will return a 6 bit relabeling byte number in the A 
register, this places the byte in the user's PMT's but not (!!!) in 
his relabeling. In order to gain access to the byte, the program 
must do a BRS 44 on the byte number returned in A. If the sign bit 
is 0, then Exec status is required to do a BRS 3. If the sign bit is 
1, then the byte 100B system is required, otherwise subsystem 
status is tested for. If the original owner of that pages kills 
that page, the pointer to that page will be removed from the current 
forks relabeling. If the byte is 150B, 151B or bytes 165B - 167B, then 
user status is allowed. 



Subsystem Relabeling Byte Table 



Subsystem 


Relabeling or , 


SMT byte(s 


) numbers 




BFortran 


(C) 


201 


202 


203 


204 


205 


206 


207 


210 


BFortran 


(R) 


31 


32 


33 


34 


35 








Cal 




112 


113 


114 


115 


116 








Common 




132 


133 


134 












DDT 




41* 


42* 














Editor 




26 


27 


30 












f2C 




163 


164 














F20S 




165* 


166* 


167* 












FOS 




150* 


151* 


152* 












FTC 




130 


131 














MUSE 




147 


153 


154 


155 


170 


175 


176 


177 


NBAS I C 




117 


120 


121 


122 


123 


124 


125 


156 


SBASIC 




101 


102 


103 


104 


105 


106 


107 




Sfortran 




135 


136 


137 


140 


141 


142 


143 


144 


XDDT 




36* 


37* 















211 21 



213 214 



157 160 161 



An asterisk indicates that the byte is available to user status programs. 
BRS 3 Status Table 
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Byte no. Read Only Read/Urite 

Byte 44B System Exec 
43B Byte 77B System Exec 
Byte 77B Subsystem Exec 

Instruction Traps: Insufficient status, bad byte number. 

♦BRS 4* 

Date: 71/09/03 

Name: [kill] page from address 

Status: User 

Input: A= Address in page wanted to kill 

Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Releases page that the address in A points to. 
If any fork has this page in it's relabeling, it is cleared from it. 
Instruction traps: Attempt to release SMT. Insufficient status when 
trying to release the TS page. 

♦BRS 5* 

Date: 71/09/03 

Name: Return status of calling [fork] 
Status: User 
Input : None 

Output: A= Status of calling fork 
B= Same as input 
X= Same as input 
Description: Reads status of calling fork and returns number 
in A: 0= No status 

1= Subsystem 

3= System 

7= Exec 
Instruction traps: None. 

♦BRS 6 + 

Date: 71/09/03 

Name: Set [file parameters] (declare file) 

Status: User or system 

Input: A= [file directory pointer address] (from BRS 15 or 48) 

X= File parameter bits (see below) 
Output: A= destroyed 
Skip Return: B= Destroyed 
(success) X= Destroyed 

Return: A= Destroyed 
(failure) B= Destroyed 
X= Destroyed 
Description: Sets the file directory bits as the declare command 
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would. Bits 0-11 of X contain a mask of the bits that are to be 
changed. Bits 12-23 of X contain the new values the program 
wishes them to be. If X= -1, then the premium charge is turned on. 
This requires system status. The following is a list of valid bits 
for the X register: 

Bits 12-23 of X = XWV USR QNM LKJ 



X= Public remote (4B3) . Allows program to access files from the 
directory from which the program was called. 

W= Public write (2B3) . Allows other users out the account to write 
on the file. 

V= Reserved. (1B3) not currently used 

U= Not private read (4B2) . Prevents user from reading file in his 
own directory. 

S= Not private write (2B2) . Makes the file "read only". 
R= Append only. (1B2) . Any output to this file is append to the 
file and the file contents not cleared. 

Q= Account public. (40B) available to the entire account. 
N= Proprietary. (20B) . The memory is cleared after the program ter- 
minates. Also not private readable. 

M= Subsystem stutus. (10B). Starts fork up with subsystem status. 
L= System status. (4B) . Starts fork up with system status. 
K= Exec status. (2B) . Starts fork up with Exec status. 
J= Init, flag. (1B) . Runs program when user logs in. 



•v fai"\ c? 



1UO U.J. LAW V-J-V-'J-A V^J- UJ^iD 



*BRS 7* 



71/09/03 

Read [monitor tables] 

Dependent on table (see below) 

A= Address in program memory where table is to be 

written. 
X= Table number 

A= Address of first word beyond table in user's buffer 
B= Same as input 
X= Same as input 
Description: Reads a monitor table and places it in the user's 
memory. If the sign bit of A is on, the BRS 7 will copy the 
user's buffer into the monitor. This always requires EXEC status. 

Description 



Date: 
Name: 
Status 
Input: 



Output: 



Table 


Read 


Write 


Table 


no. 


Status 


Status 


Size 





System 


Exec 


45B 


1 


System 


Exec 


20D 


2 


System 


Exec 


10D 


3 


System 


Exec 


32D 


4 


System 


Exec 


6D 


5 


System 


Exec 


32D 


6 


System 


Exec 


40D 


7 


System 


Exec 


42d 



Miscellaneous Monitor Counters 

RAD Error List 

Disc Error List 

Activation Swap Counters 

Multiplexer Communication 

Real Memory Table 

Global File Flags 

Job to Teletype Conversion 
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ALARM. 

Global Index Block Pointers 
Highest Disk Address 
Machine Number in Ascii 
Eqpt. Equptment 
Accounting Cursor Positions 
WERIS Table 
PMTP Table 
CPARW Table 
AUNN Table 
FGLIST Table 
Monitor Table 
RAD Bit Map 
ETTB Table 
PTCKS Table 
CCT Table 
TTYASG Table 
Queue Tables 
Montab Table 

For further information, see Appendix A. 

Instruction traps: Illegal table number, insufficient status for 

read or write. 



8 


System 


Exec 


1D 


9 


Sy s tern 


Exec 


40D 


10 


System 


Exec 


1D 


11 


User 


Exec 


ID 


12 


User 


Exec 


1D 


13 


User 


Exec 


2D 


14 


System 


Exec 


NPORT 


15 


System 


Exec 


NJOB 


16 


System 


Exec 


NJOB 


17 


System 


Exec 


NJOB 


13 


System 


Exec 


NJOB 


18 


System 


Exec 


19D 


19 


System 


Exec 


32D 


20 


System 


Exec 


NJOB 


21 


Systen 


Exec 


NJOB 


22 


System 


Exec 


NJOB 


23 


System 


Exec 


NPORT 


24 


System 


Exec 


20D 


25 


System 


Exec 


2D 



*BRS 8* 

Date: 71/09/03 

Name: [close] all [file]s 

Status : Exec 

Input: None 

Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Closes all open files, but doesn't reset CIN or TOUT. 
Used by the Exec before logging the user out. 
Instruction traps: Insufficient status. 

*BRS 9* 

Date: 71/09/03 

Name: Start [fork] 

Status : User 

Input: A= Bits 0-7= Fork bits (see below) 

3-23= Address of [panic table] 
Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Creates dependent entries in the [PAC] table entries 
for each user. A fork which calls a BRS 9 is called the [controlling 
fork] . The fork produced by the BRS 9 is called the [lower fork] . 
Each controlling fork may be a lower fork for some other controlling 
fork. The controlling fork is dismissed until the lower fork terminates. 
A user cannot have over 8 forks (this includes the Exec fork and each 
fork for an Exec BRS in progress) . Only one Exec BRS can be active at 
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a time. If a fork attempts to start a lower fork with status higher 
than itself, the BRS 9 will ignore it. 

Fork bits: 

Bit 0= Give fork [Exec status] if controlling fork has Exec status 
1 = Set fork relabeling from panic table. Otherwise, use the 

current relabeling of the controlling fork 
2- Propogate [panic assignment] to fork if controlling fork 

has it. (See BRS 90) 
3= Make fork [fixed memory] . It is not allowed to gain more 

memory. Any attempts will result in a memory trap. 
4= Make fork [local memory] • New memory is 
5= Give fork [subsystem status] if issuing fork has subsystem 

status. 
6= Give fork [system status] if issuing fork has system status. 

Panic table format: 

Word Description 

Program counter 

1 A register 

2 B register 

3 X register 

4 First relabeling register 

5 Second relabeling register 

6 Status word. -2 = Dismissed for input/output 

-1 = Running 

= Dismissed on [panic] or BRS 10 

1 = Dismissed on instruction trap 

2 = Dismissed on memory [trap] 

Instruction traps: Issuing fork was under local memory bounds, panic 
table overlaps page boundry, attempting to restart same fork, attempt to 
create 9th fork. 

*BRS 10* 

Date: 71/09/08 

Name: Programmed Panic [terminate] s a [fork] 

Status: User 

Input : None 

Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Terminates a fork in much the same manner as a 
panic would do. The only difference between a BRS 10 and a panic is 
that the program counter points to the BRS 10. This BRS is normally 
used to terminate a running fork when it is finished. 
Instruction traps: None. 

♦BRS 11* 
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DATE; 71/09/08 

Name: Clear [input buffer] 

Input: X= Port number (-1, or 1 for command port) 

Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Clears the input buffer. 
Instruction traps : Bad port number in X (takes interrupt 10 if armed) . 

*BRS 12* 

DATE: 71/09/09 

Name: Set [echo table] 

Status : User 

Input: A= Echo table number or terminating character for 8 level input. 

X= Port number (0 or -1 for [command port] ) 
Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: If the sign bit of A is on, then the low order 8 bits of 
A contain the character to terminate on. In 8 level mode, characters 
are read from the [terminal] and transmitted unchanged to the user program, 
If bit 15 (400B) is on, there can be no terminating character. 
The program must terminate the 8 level mode by itself, or the user will 
be hung and must hang up his phone. If bit 4 (2B6) is on, 8 level output 
mode is set. 

Echo tables: (In X): 

0= [echo] each character as it was received and break on all 

characters. 
1= Echo each character and break on all letters, digits and spaces. 
2= Echo each character and break on control characters (including 
carriage return and line feed) . This is the normal mode set 
by the Exec. 
3= No echo for each character and break on all characters. 
Instruction traps: Bad echo table in A. 

*BRS 13* 



DATE: 71/09/20 

Name: Skip if characters in [input buffer] 

Status: User 

Input: X= Port number (-1, or 1 for command port) 

Output : 

A= Preserved 

B= Preserved 

X= Preserved 

A= Preserved 

B= Preserved 

X= Preserved 

Skip if there are any characters in the input buffer. 



Skip return: 
(success) 

return: 
(failure) 

Description: 



Instruction traps: Bad port number in X (takes interrupt 10 if armed) . 
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*BRS 14* 

Date: 71/0 8/20 

Name: [Dismiss] until [output buffer] empty 

Status: User 

Description: Dismisses the user until [output backpressure] has ceased. 

Note: This BRS is obsolete. The recommended new BRS is BRS 164. 

Instruction traps: Bad port number (if int. 10 is not armed) . 

*BRS 15* 

DATE: 71/09/21 

Name: [Lookup] [file] in [file directory] 

Status : User 

Input: A= Command file 

Output: 

Skip return: A= File directory pointer address 

(success) B= Destroyed 

X= File directory pointer address 
return: A= Destroyed 
(failure) B= Destroyed 

X= Exec ercode 
Description: Inputs a file name (see Glossary) from the command file 
in A and looks it up in the appropriate file directory. If the file 
does not exist, or the file name is in bad form, the non-skip return 
is taken: 
Instruction traps: Bad file number in A. 

♦BRS 16* 

DATE: 71/09/21 

Name: [Open] [file] from file directory pointer address 

Status: User 

Input: A= File directory pointer address 

Output : 

Skip return: A= File number 

(success) B= File type (see Glossary) 

X= File size 

return: A= Destroyed 

(failure) B= Destroyed 

X= Exec ercode (see Appendix D) 
Description: Opens a file looked up by a BRS 15, 48 or 68. The 
BRS fails if the file directory pointer address in A is not pointing 
to a proper location in the TS block or if the file cannot be opened. 
(See BRS 62 for more information on an opening) . 

NOTE: The BRS 16 does not (II!) allow the user to set extra-ordinary 
file privilege bits. The only ones set are ability to do an SCP and 
read mode. 
Instruction traps : None 

*BRS 17* 
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Date: 71/0 8/20 

Name: [Close] all [files] 

Status : User 

Input: None 

Output: A= Same as Input 

B= Same as Input 

C= Same as Input 
Description: Closes all open files, sets [command file] to teletype 
and [TOUT] file to teletype. 
Instruction traps: None 

*BRS 18* 

DATE: 71/09/21 

Name: [Lookup] [file] for output 

Status : User 

Input: A= Command file 

Output: 

Skip return: A= File direct; ory pointer address 

(success) B= Confirming character 

X= Destroyed 

return: A= Destroyed 

(failure) B= Destroyed 

X= Exec ercode (see Appendix D) 
Description: The BRS reads the file name (see Glossary) 
from the command file and tests it for validity. If the file name is 
improperly constructed, the non-skip return will be taken. If the 
"New File"/ M 01d File" message is to be typed, bit 1 of A must be on. 
Instruction traps: Bad file number in A. 

*BRS 19* 

DATE: 71/09/21 

Name: [Open] [file] for output from file directory pointer address 

Status : User 

Input: A= File directory pointer address (from BRS 18 only!!!) 

X= File type (see Glossary) 
Output: 

Skip return: A= File number 
(success) B= Old file type 

X= Destroyed 

return: A= Destroyed 

(failure) 3= Destroyed 

X= Destroyed 
Description: Opens the file input to the BRS 18 for output. The 
skip output contains the same information as a BRS 63. If the file 
cannot be opened the non-skip return will be taken. 
NOTE: This BRS cannot set any random file bits. It is opened as 
a BRS 63 would (e.g., erase the file). 
Instruction traps: Bad file type in X. 

*BRS 20* 

Date: 71/0 8/20 
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Name: [Close] a [file] 
Status : User 

Input: A= Open file number 
Output: A= Same as Input 

B= Same as Input 

X= Same as Input 
Description: Closes the file with the file number in A. If any disc 
use is pending on this file, the monitor will dismiss until it is com- 
pleted. If the file is open for output or update and currently in write 
mode, the file is erased from the cursor to the end of file. 
Instruction traps: Bad file number, file not open 

*BRS 21* 

Date: 71/08/20 

Name : F1JA 

Status : User 

Input: A= Floating Point number 

B= Floating point number 
Output: A= Negated point number 

B= Negated point number 
Description: The double work [floating point] number in A and B 
is negated and returned to A and B. 
Instruction traps : None 

*BRS 22* 

Date: 71/03/20 

Name: Prevent fork from being terminated 

Status : Exec 

Input : None 

Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Prevents fork from being terminated on quantum over- 
flow or I/O dismissal. 
Instruction traps: Insufficient status 

*BRS 23* 

Date: 71/0 8/20 

Name: Allow fork to be terminated 

Status : Exec 

Input : None 

Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Allows fork to be swapped immediately. The pages are 
unlocked and released (not killed!) 
Instruction traps: Insufficient status 

♦BRS 25* 

Date: 71/0 8/20 
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Name: Grab bit from map 

Status: Exec 

Input: A= Disk address to grab from disc [bit map] 

Output : 

Skip Return: A= Same as input 

B= Same as input 

X= Same as input 
Return: A= Same as input 

B= Same as input 

X= Same as input 
Description: Grabs bit from bit map and skips if none of the following 
conditions exist: 

1) Bit map not set 

2) Bit already mapped 

3) Garbage in A (improper address in A) 

This BRS is used by the MAP routine to reserve a disk page on 

each disc pack on 2314 systems and to reserve the statistics blocks. 

if any exist. 

Instruction traps: Insufficient status. 

♦BRS 26 + 

Date: 71/0 8/20 

Name: Skip if [Panic] or [Off Interrupt] Pending 

Status: User 

Input: None 

Output : 

Skip Return: A= Same as input 

B= Same as input 

X= Same as input 
Return: A= Same as input 

B= Same as input 

X= Same as input 
Description: Skips if an interrupt is pending on the [phantom user] 
queue (for bRS 46 and 47) or if an interrupt is stack while a BRS 113 
or 114 is set. 

Note: This 3RS will not work for BRS 161 or 162. 
References: BRS 46, 47, 161, 162 
Instruction traps : None 

♦BRS 27 ♦ 

Date: 71/0 8/20 

Name: Start [Statistics] 

Status : Exec 

Input: None 

Output: A= current buffer number 

B= Same as input 

X= Same as input 
Description: The first time it is called, the BRS 27 sets STSW to -1 
and returns A= (initial buffer number) . If the BRS 27 is called 
after statistics are turned on, A returns the current buffer number. 
Instruction traps: Bit map not set, insufficient status 
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*BRS 28* 

Date: 71/0 8/20 

Name: Stop [Statistics] 

Status: Exec 

Input: None 

Output: A= Same as input 

B= Same as input 

X= Same as input 
Description: Stops statistics by placing 3777777B in STSW, also 
writes out last buffer and appends end of statistics record type. 
Instruction traps: Insufficient status 

*BRS 29* 

Date: 71/0 8/20 

Name: Clear [output buffer] 

Status : User 

Input: X= -1 or for user's [command port] 

Output: A= Same as input 

B= Same as input 

X= Same as input 

Description: Sends a [character gobbler] in the downstream direc- 
tion, clearing characters out. 

Instruction traps: Improper port number in X (if interrupt 8 
is armed, it will occur instead) , port not output port. 

*BRS 30* 

Date: 71/0 8/20 

Name: Give bit back to [bit map] 

Status : Exec 

Input: A= Disc address to release from map 

Output : 

Skip Return: A= Same as input 

(success) B= Same as input 

X= Same as input 

Return: A= Same as input 

(failure) B= Same as input 

X= Same as input 
Description: Returns the disc address in A to the bit map, if the 
following conditions do not apply: 

1) Bit map not set 

2) Garbage in A improper address in A) 

3) Bit already mapped 

Instruction traps: Insufficient status 

*BRS 31* 

Date: 71/08/20 

Name: Wait for specified [fork] to [terminate] 

Status: User 
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Input: A= [Panic table] address 
Output: A= Same as input 

B= Same as input 

X= Status of fork (reason for termination) 
Description: Dismisses until the specified fork panics in some way 
X contains the status word as returned by the BRS g. 
Instruction traps : None 

♦BRS 32* 

DATE: 71/07/22 

Name: Clean up -2 or -3 

Status: System 

Input: X = Port number 

Output: A = Same as Input 

B = Same as Input 

X = Same as Input 
Description: Places a "never run" actiration condition for the channel 
in X, 
Instruction Traps: Insufficient status 

*BRS 33* 

DATE: 71/09/21 

Name: Read [string] 

Status : User 

Input: A= Address of a [string pointer] 

B= Terminating character 

X= Input [file number] 
Output: A= First word of string pointer 

B= Second word of string pointer 

X= Same as input 
Description: Reads a string from the input file until the character 
in B is reached. When the BRS returns, it modifies the string 
pointers in memory and places them in the A and B registers. 
The terminating character is not appended to trie string. 
Instruction traps: Illegal file number in X. 

*BRS 34* 

Date: 71/0 8/20 

Name: Write [message] 

Status : User 

Input: A= Address of message in memory 

B= -1 to terminate on /, $= carriage return or the number 
of characters to print. 

X= Output [file number] 
Output: A= Last Character in string 

B= Destroyed 

X= Preserved 
Description: If B is equal to -1, then the BRS will print out the 
message whose address was contained in the A register. In this mode, all 
dollar signs ($) are printed on carriage returns and the end of a 
message is signified by a slash (/) . If B is positive, it will be 
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the number of characters to be printed starting at the location 
in A. 

Example: To print the message "Tymshare BRS manual" followed by a 
carriage return : 

PRINT LDA =MSG; LDB =-T; LDX =1 (To terminal); BRS 34; ... 
MSG ASC 'Tymshare BRS manual $/* 

Note: The message must be in 7 bit ASCII, not 6 bit text. 
Instruction Traps: Bad File number in X 

*BRS 35* 

Date: 71/0 8/20 

Name: Write [string] 

Status: User 

Input: A= First word of string pointer 

B= Second word of string pointer 

X= Output [file number] 
Output: A= Destroyed 

B= Destroyed 

X= Preserved 
Description: Writes the string whose string pointers are contained in 
A and B to the file number in X. If system status is set, control 
characters will be written as S character (as in EDITOR) . 
Instruction traps: Illegal file number in X. 

*BRS 36* 

Date: 71/0 8/20 

Name: Write [number] 

Status : User 

Input: A= Number to be written 

B= Radix ( 1) 

X= Output [file number] 
Output: A= Same as input 

3= Same as input 

X= Same as input 
Description: Writes the number in A to the file specified in X. 
Radixes up to 16 (hexidecimal) will work. 
Instruction traps: Illegal file number in X, bad radix in B. 

*BRS 37* 

DATE: 71/09/22 

Name: [Rename] a [file] to same length 

Status : User 

Input: A- First word of string pointer 

B= Second word of string pointer 

X= [File directory pointer address] 
Output: 

Skip Return: A= Destroyed 
(success) B= Destroyed 



-27- 



Tymshare BRS Manual BRS'S IN NUMERICAL SEQUENCE 

X= Destroyed 

return: A= Destroyed 

(failure) B= Destroyed 

X= Exec ercode 
Description: Renames the file whose file directory pointer address 
is in X to the file name (see Glossary) pointed to by A and B. The 
length of the new string (including comments) must be the same as the 
old string. 
Example: LDP OLDPTR; BRS 48; BRS 10; LDP NEWPTR 

BRS 37; BRS 10; ... 
OLDPTR DATA 3*OLDSTR-1 , 3*OLDSTR+7-1 
NEWPTR DATA 3*NEWSTR-1 , 3*NEWSTR+7-1 
OLDSTR ASC 'OLDNAME' 
NEWSTR ASC 'NEWNAME' 

Instruction traps: None. 

*BRS 38* 

Date: 71/0 8/23 
Name: Read [number] 
Status: User 
Input: B= Radix ( 1) 

X= Input [file number] 
Output: A= Number 

B= Terminating character 

X= Same as input 
Description: Reads a number from the file specified by the file 
number in X until a non-numerical (this includes .) character is found 
A dash (-) as the first character will negate the number. 
Instruction traps: Illegal file number in X, bad radix in B. 

♦BRS 39* 

Date: 71/0 8/23 

Name: Read [control parameter word] 

Status : User 

Input: None 

Output: A= Control parameter word (see table below) 

B= [Universal user number] 

X= Same as input 
Description: Reads tne control parameter word into the A register 
and the universal user number into B. The A register has the 
following significance: 

4B7 = Tymshare (Proprietary) Status 

2B7 = Not Used. 

1B7 = Operator Status. 

4B6 = Oper Login 

2B6 = Account Supervisor 

1B6 = Not Used. 

4B5 = Project Code Validation Required. 

2B5 = Validated on 2 or more Computers 

1B5 = Not Used 



-28- 



Tymshare BRS Manual 



BRS'S IN NUMERICAL SEQUENCE 



4B4 = Not allowed to change own password 

2B4 = Not Used. 

1B4 = Reserved. 

2B = "MAIL WAITING" message waiting 

Instruction traps: None 



*BRS 40* 

DATE: 71/09/21 

Name: Reads [echo table] 

Status: User 

Input: X= Port number (-1, or 1 for command port) 

Output: A= Echo table number + terminal characteristics 

B= Preserved 

X= Preserved 
Description: Reads echo table. (See BRS 12). The BRS also returns 
the following bits in A: 



Bit 





(4B7) 


= 


Eight Level Input 


Bit 


2 


(1B7) 


= 


Lower Case Input 


Bit 


4 


(2B6) 


= 


Eight Level Output 


Bit 


5 


(1B6) 


= 


Echo Control I 


Bit 


6 


(4B5) 


= 


Echo LF as CR 


Bit 


7 


(2B5) 


= 


Echo CR as LF 


Bit 


15 


(2B4) 


= 


Lower Case Output 



Instruction traps: Bad port number in X (unless interrupt 
10 is armed) . 

*BRS 41* 

Date: 71/0 8/23 

Name: Read disc address of current [data block] 

Status: System 

Input: None 

Output: A= Disc address of current data block 

B= Preserved 

X= Preserved 
Description: Reads the disc address of the current data block for the 
last file accessed. Used in MAP for the raw accounting file. 
Instruction traps: Insufficient status 



*BRS 42* 



Date: 

Name: 



71/08/23 
Read clock 



Status: User 

Input: None 

Output :_ A= Number of clock ticks since startup 

B= Last time of system start up 

X= Year - 196 4 
Description: Returns the number of clock ticks (1/60 sec) since startup 
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in A, the last system start up time in B, and the year - 196 4 in X. 
Instruction traps: None 

*BRS 43* 

DATE: 71/09/21 

Name: Read pseudo- [relabeling] 

Status: User 

Input : None 

Output: A= First relabeling register (See Glossary) 

B- Second relabeling register 

X= Preserved 
Description: Reads the pseudo-relabeling registers (See Appendix G) 
for the currently active fork into A and B. 
Instruction traps: None 

*BRS 44* 

DATE: 71/09/21 

Name: Set pseudo- [relabeling] 

Status: User, system or Exec 

Input: A= First relabeling register (See Glossary) 

B= Second relabeling register 

B= Preserved 

X= Preserved 
Description: Sets the pseudo-relabeling for the current running fork. 
If one of the bytes is 44B and is read-only, it will require at 
least system status to relabel over; if it is read write, it will require 
Exec status to relabel over. See Appendix G for further information 
on relabeling. 

Instruction traps: Swap error, insufficient status to relabel page, 
attempt to relabel over a non-existent page (not the way to obtain more 
memory ! ) . 

*BRS 45* 

Date: 71/03/23 

Name: [Dismiss] for 4 seconds 

Status: User 

Input : None 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Dismisses for 3 seconds 
Instruction traps : None 

*BRS 46* 

Date: 71/00/23 

Name: Set [non-terminability] 

Status : Exec 

Input: None 

Output: A= Preserved 
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B= Preserved 

X= Preserved 
Description: After setting non-terrainability, the first panic typed 
is stacked and further panics forgotten. A waiting panic can be tested 
for with a BRS 26. 
Instruction traps: Insufficient status 

♦BRS 47* 

Date: 71/08/23 

Name: Clear [non- terrain ability] 

Status : Exec 

Input : None 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Clears non-terminability and remembers the stacked 
panic , if any. 
Instruction traps: Insufficient status 

♦BRS 48* 



DATE: 71/09/21 

Name: [Lookup] [file] in [file directory] using string pointers 

Status: User 

Input: A= First word of string pointers 

B= Second word of string pointers 
Output: 
Skip return: 
(success) 



A= File directory pointer address 

B= Destroyed 

X= File directory pointer address 

A= Preserved 

B= Preserved 

X= File directory group number 

Takes the string pointer in A and B and looks it up in 
the appropriate file directory. If the file name (see Glossary) is 
badly constructed, or cannot be found, the non-skip return is taken. 
The error return can be used to find the file directory group number. 
Instruction traps : None 



return : 
(failure) 

Description: 



*BRS 49* 

Date: 71/0 8/23 

Name: Read [interrupts] armed 

Status : User 

Input: None 

Output: A= Interrupts armed (see BRS 78) 

B= Preserved 

X= Preserved 
Description: Reads the interrupt mask into the A register. 
Instruction traps: None 

♦BRS 50* 
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DATE: 71/09/21 

Name: [Conversion] from [floating point] to fixed point 

Status : User 

Input: A- First word of floating point number 

B- Second word of floating point number 
Output: A= Integer part 

B= Fractional part 

X= Preserved 
Description: Fixes the floating point number in A and B to A. The 
fraction part is placed -in B left justified. 
Instruction traps: None 

*BRS 51* 

DATE: 71/09/21 

Name: [Conversion] from fixed point to [floating point] 

Status : User 

Input: A= Integer value 

Output: A= First word of floating point number 

B= Second word of floating point number 

X= Preserved 
Description: Converts the integer in A to a normalized floating 
point number in A and B. 
Instruction traps: None 



*3RS 52* 



DATE: 71/09/21 

Name: [Format] ted input 

Status : User 

Input: X= Format (See Appendix E) 

Output : 

A= First word of floating point number 

B= Second word of floating point number 

X= Destroyed 

A= Destroyed 

B= Destroyed 

X= Error code (See Appendix E) 

Reads characters from the file specified through the format 

register. If any errors exist, the non-skip return will 



Skip return: 
(success) 

return: 
(errors) 



X 



Description: 
word in the 
be taken. 
Instruction traps: 



Bad file number in X. 



*BRS 53* 

DATE: 71/09/21 

Name: [Format] ted output 

Status: User 

Input: A= First word of floating point number 

B= Second word of floating point number 

X= Format (See Appendix E) 
Output: A- Preserved 



-32- 



Tymshare BRS Manual BRS'S IN NUMERICAL SEQUENCE 

B= Preserved 

X= Preserved 
Description: The floating point number (or integer) is output to the 
file number in the X register according to the formats listed in Appendix 
E. 
Instruction traps: Bad file number in X. 

*BRS 54* 

Date: 71/08/23 

Name: Grab bit from [bit map] 

Status : Exec 

Input : None 

Output: 

Skip Return: A= Disc address of bit grabbed 

B= Preserved 

X- Preserved 
Return: A= Preserved 

B= Preserved 

A- Preserved 
Description: Grabs a bit from the bit map and returns the disc 
address of that bit. If the map is not set, the BRS will not skip. 
Instruction traps: Insufficient status 

♦BRS. 55* 

Date; 71/08/23 

Name: Dismiss until disc work done 

Status: User 

Input: None 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Dismisses the job until all of the pending disc 
work is done. 
Instruction traps: None 

♦BRS 56* 

DATE: 71/09/20 

Name: Make [PMT] pointer indirect for [Recover] 

Status : Exec 

Input: A= PMT byte number or SMT byte number to be pointed at. 

B= PMT number 

X= Channel number for new byte 
Output: A= New byte number 

B= Preserved 

X= Preserved 
Description: Recovers the page in A and places it in the byte number 
specified in B. Used by the Exec in the "recover" command. 
Instruction traps: Bad byte number in B. 

♦BRS 57* 



-33- 



Tymshare BRS Manual 



BRS'S IN NUMERICAL SEQUENCE 



Date: 71/0 8/23 

Name: Make [expanded SHT] byte accessable to users 

Status : Exec 

Input: A= Expanded SMT number 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Makes the byte in A accessable to users without status 
Used in WSD for FOS, F20S 
Instruction traps: Insufficient status, bad byte number 

*BRS 58* 

DATE: 71/09/16 

Name: [Rename] a [file] 

Status: User 

Input: A= First word of string pointer for old name 

B= Second word of string pointer of old name 

(Also first word of string pointer of new name) 

X= Second word of string pointer of new name 

Output : 

Skip return: A= Destroyed 

(success) B= Destroyed 

X= Destroyed 
return: 

(failure) A= Destroyed 

B= Destroyed 

X= Ercode (see Appendix D) 

Description: Renames the old file pointed to by A and B 
to the file name string concatenated to the old string as pointed 
to by B and X. If any errors occur, the non-skip return will be 
taken and the ercode put in X. Example: 

RENAME LDP OLDPTR; LDX NEWPRT+1 ; BRS 58 
BRU ERROR (Error Routine) ; ... 

OLDPTR DATA 3*OLDSTR-1 

NEWPTR DATA 3*OLDSTR+6 

DATA 3*OLDSTR+17 

OLDSTR ASC ' OLDFILEHEWFILENAME ' 

The BRS 58 differs from the BRS 37, in that it can rename files to 
file lengths different than the old length. 
Instruction traps: None 

*BRS 59* 

DATE: 71/09/16 

Name: Change effective [User Name] for public files 

Status: User 

Input: A= Desired character to be used in user name in place of #. 

Output: A= Destroyed 
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B= Destroyed 

X= Destroyed 
Description: The Exec will substitute the selected character in place 
of every occurance of a "#" discovered in a user name. If the mode 
is to be reset, then A is to be set to -1 and the BRS called again. 
Instruction traps: None 

*BRS 60* 



DATE: 71/09/16 

Name: Lookup [file name] in [file directory] for output 

Status : User 

Input: A= First word of string pointer 

B= Second word of string pointer 
Output : 
Skip return: 
(success) 



A= File directory pointer address 

B= Destroyed 

X= File directory pointer address 

A= Destroyed 

B= Destroyed 

X= Ercode (see appendex D) 

The file name is looked up in the file directory and checked 
(see Glossary) . The BRS 60 is usually followed by a 
BRS 19. The BRS 60 is to the BRS 19 as the BRS 48 is to the BRS 16. 
Instruction traps: None 



return : 
(failure) 

Description: 
for legality 



DATE: 71/09/16 

Name: [Open] [file] for [input] 

Status: User 

Input: A= Bits 0-7 = random file options (see Appendix B) 

8-23= command file number 
Output: 
Skip return: 
(success) 



A= File number 

B= File type (see Glossary) 

X= File size in characters 

A= Destroyed 

B= Destroyed 

X= Exec ercode (see Appendix D) 

Reads the input file name from the command file specified 
in bits 8-23 of A. (See Glossary on valid file names) . If bits 0-7 
are 0, the default will be: 1) . The ability to do an SCP and 2). The 
file is set to read mode. Any attempt to open an input file for 
output will result in a trap. 

Instruction traps: Attempt to set write mode, bad command file number 
in A. 



return: 
(failure) 

Description: 



*3RS 63* 

DATE: 71/09/16 

Name: [Open] [file] for [output] 

Status: User 

Input: A= Bits 0-7 = random file options (see Appendix B) 
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8-23= command file number 
X= File type 
Output : 
Skip return: A= File number 

B= Old file type (if any) 

X= Destroyed 

A= Destroyed 

B= Destroyed 

X= Exec ercode (see Appendix D) 

Reads the output file name from the command file specified 
in bits 8-23 of A, (See Glossary on valid file names) . If 
bits 0-7 are f the default is taken to be: 1). The ability to do an 
SCP, 2) . The ability to erase information (PCE) and 3) . The file is 
set to write mode. If the read mode bit is on, the file is opened as 
[random I/O] and the original contents of the file are not destroyed. 
If the file being opened for random I/O is an append only file, any 
attempts to do a PCE will fail. If bits 0-7 of A are 0, the file is 
erased and all data blocks released. 
Instruction traps: Bad command file number in A. 



(success) 

return 
(failure) 

Description: 



*BRS 64* 



DATE: 71/09/16 

Name: [Open] [file] for [input] using string pointers 
Status: User 

Input: A= bits 0-7 = random file options (see Appendix B) 
bits 8-23= first word of string pointer 
B= second word of string pointer 



Output : 
Skip return: 
(success) 



return: 
(failure) 



A= File number 

B= File type (see Glossary) 

X= File size in characters 

A= Destroyed 

B= Destroyed 

X= Exec ercode (see Appendix D) 
Description: Opens the file whose string pointers are in A and B 
for input. The BRS 64 obeys all the rules regarding random files as 
the tBRS 62. See BRS 6 2 for further information. 
Instruction traps : None 



♦BRS 65* 

DATE: 71/09/16 

Name: [Open] [file] for [output] using string pointers 
Status : User 

Input: A= bits 0-7 = random file options (see Appendix B) 
bits 8-23= first word of string pointers 
3= Second word of string pointers 
If 'OLD FILE 1 /'NEW FILE 1 message is to be typed: 
X= bits 0-1 1 = file type (see Glossary) 

bits 12-23= command file number 
If *OLD FILE' / , NEW FILE' message is not to be typed: 
X= bits 0-11= 

bits 12-23=file type (see Glossary) 
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Output: 
Skip return: 
(success) 

return : 
(failure) 

Description: 
for output. 



A= file number 
B= Old file type (if any) 
X= Destroyed 
A= Destroyed 
B= Destroyed 

X= Exec ercode (see Appendix D) 

Opens the file whose string pointers are in A and B 
The BRS 65 obeys the same rules for random files as the BRS 



63. See the BRS 63 for further information. The main difference is the 
'OLD FILE 1 /'NEW FILE' question, which can be controlled by the setting 
of bits 0-11 of X. 
Instruction traps: Bad command file number in X. 

♦BRS 66* 

DATE: 71/09/16 

Name: Erase disc [file] 

Status : Exec 

Input: A= File number 

Output : 



Skip return: 
(success) 

return : 
(failure) 

Description: 

The non-skip return is taKen ir tne map is not set or on I/O error. 



A= Preserved 
B= Preserved 
X= Preserved 
A= Preserved 
B= Preserved 
X= Preserved 
Erases the file whose file number is in A. 



_ j i, 



Instruction traps : 
opened. 

*BRS 67* 



Insufficient status, bad file number or file not 



DATE: 71/09/17 

Name: Read [TS page] 

Status: User 

Input: A= Index into table 

B= Location in user • s memory 

X= Number of words to be copied into memory 
Output: A= Destroyed 

B= Destroyed 

X= Destroyed 
Description: Reads into memory a section of the user's 



page 



The index will allow the program to get only a selected portion. 
To print out the project code: 

PRO J 



BFR 



Example 



LDA 


=59; LDB =BFR; LDX = 4; BRS 67 


LDA 


=BFR; LDB =12; LDX =1; BRS 34 


TCO 


=155B; BRS 10 


BSS 


4 



List of indices: 
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List of Indicies for the BRS 67: 
Index Description 



0-5 Words 2-6 of the Exec Panic Table 

6 Command Input File 

7 Command Output File (TOUT File) 

8 User Number 

9 Status Flag Word 
10-14 Exec Pop Vectors 
15-16 Exec Relabeling 
17-18 Program Relableing 
19-20 Subsystem Relabeling 

21 Number of clock ticks at Login 

22-28 Exec Panic Table 

29 Ercode (See Appendix D) 

30 REMAC 

31 Account Number 

32 File Directory LUD locator 

33 LUD locator for this user (Same as WERIS) 

34 File Directory User Number 

35 Current Group Number 

36 Number of Groups 

37 Last Exec ID number 
38-39 Temporary Exec Storage 

40 Used as switch for type of Logon for Accounting 

41 Disc Buffer Location in Exec 

42 BRS 48/60 switch, negative if BRS 48/60 

43 Proprietary Program Switch 

44 Break Table for Exec BRS's 

45 File Directory Account Number (Set by GFD) 

46 Init Switch 

47 Next Account Storage (For Disc Error) 
48-54 Temporary Exec Storage 

55 Name Change Character (-1 for Non Active) See BRS 59 

56 Error Switch (-1 to type all Error Messages) 

57 SWOFF 
5 8 SWTM 

59-62 Project Code 

63 File Position in directory 

64 File Directory Pointer Address for last File 

65 Current File Directory Group Number 

Warning: If the buffer specified does not point to page somewhere 
in the relabeling, the Exec will place the data in a new page if 
possible, but will not (!!!) affect the user relabeling. 
Instruction traps: Bad index in A. 

♦BRS 6 8* 

DATE: 71/09/17 

Name: Reads [file] name from [file directory] into memory 

Status: User 
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Input: A= Null string pointer 
B= Null string pointer 
X= Index to file into file directory 
Output : 

Skip return: A= File directory pointer address 
(success) B= Ending string pointer 
X= Destroyed 
return: A= if index is invalid 
(failure) B= Destroyed 

X= Exec ercode 
Description: Reads the file name for the index in X. If X is greater 
than the last file position, the BRS will skip. Example: Types all 
file names in a directory. 

TYPE CLX 

LOOP EAX 1,2; STX COUNT; LDP PTR; BRS 68; BRS 10 (ALL DONE) 

LDA PTR; LDX =1; BRS 35; TCO =155B;, LDX COUNT; BRU LOOP 
PTR DATA 3 * STRING- 1 , 3*STRING-1 
COUNT ZRO 
STRING BSS 3*70 

Warning: If the buffer specified does not point to page somewhere 
in the relabeling, the Exec will place the data in a new page if 
possible, but will not (!!!) affect the user relabeling. 
Instruction traps: Directory declared "Not Listable" 

*BRS 69* 

DATE: 71/09/20 

Name: [Delete] a [file] 

Status : User 

Input: A= File directory pointer address 

Output : 

Skip return: A= Destroyed 

(success) B= Destroyed 

X= Destroyed 

return: A= Destroyed 

(failure) B= Destroyed 

X= Exec ercode 
Description: Deletes the file whose file directory pointer address is in 
A. If the file is write protected, the message "WRITE PROTECTED" is 
printed and the error return taken. 
Instruction Traps: None. 

*BRS 70* 

Date: 71/0 8/23 
Name: Count free [pages] 
Status: User 
Input : None 

Output: A= Number of free pages 
B= Preserved 
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X= Preserved 
Description: Returns number of pages not in use. The amount of 
unused memory can be calculated by doing a LSI! 2 with B cleared. 
Instruction traps: None 

*BRS 71* 

Date: 71/0 8/23 

Name: Skip if System or Exec status set 

Status : User 

Input : None 

Output: 

Skip Return: A= Preserved 

B= 
= 4B7 
= 6B7 

X= Preserved 
Return: A= Preserved 

B= 

X= Preserved 
Description: Skips if the user has set System or Exec. 
Instruction traps: None 

*BPS 72* 

Date: 71/0 8/23 

Name: Exec [dismiss] 

Status : Exec 

Input: B= PTEST (see BRS 7) 

X= Queue number 
Output: 
Skip Return: A= Queue number 

B= PTEST 

X= Queue number 
Return: None, always skips 
Description: Dismisses the job on the queue in X with the PTEST 
in B. The queue numbers are: 

X Queue 






QTI 


1 


QIO 


2 


QSQ 


3 


QQC 


4 


QQE 



Instruction traps: Insufficient tables 

*BRS 73* 

Date: 71/08/23 
Name: Read [ERCODE] 
Status: User 
Input: None 
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Output: A= ERCODE 

B= Preserved 

X= Preserved 
Description: Returns the ERCODE word in A. If the ERCODE is 

99, then the address is the monitor address that detected the error, 
Instruction traps : None 

*BRS 74* 

Date: 71/0 8/23 

Note: This BRS no longer exists, use the following code: 
CLX; BRS U2; MRG =400B; BRS 160 

*BRS 75* 

Date: 71/0 8/23 

Note: This BRS no longer exists, use the following code: 
CLX; BRS 132; ETR =3400B; BRS 160 

♦BRS 76* 

Date: 71/0 8/23 

Note: This BRS no longer exists, use the following code: 
CLX; BRS 132; SKA =400B; SKIP; NON SKIP 

♦BRS 77* 

DATE : 71/09/20 

Name: Change [TOUT] file 

Status : User 

Input: A= File number 

Output: A= Old tout file number 

B= Preserved 

X= Preserved 
Description: Closes the present teletype output file if one 
is open and uses the output file specified in A. This BRS works 
in conjunction with the Exec "TOUT" command, which causes all Exec 
output to go to a file. 
Instruction traps: Bad file number in A, 

*BRS 78* 

DATE: 71/09/20 

Name: Arm/Disarm [software interrupt] 

Status : User 

Input: A= New interrupt mask 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: The new interrupt mask in A is substituted for the old 
one. A user status program may arm interrupts 1-10; a system status 
program may arm interrupt 11 (disc errors) also. Location 200B + 
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interrupt number (1-13B) must have the address of the routine 
to process the interrupt. When the interrupt occurs, the program 
counter is stored at the address of the routine and execution of the 
interrupt routine begins at the address specified in location 200B+ 
interrupt number + 1. The interrupts currently implemented are: 

No. Description of Interrupt 

1 Interrupt if Program Panic (Includes Terminal "Panics" and BRS 10s) 

2 Interrupt if Memory Panic (Read Only Violation, etc.) 

3 Interrupt if Lower Fork terminates 

4 Interrupt on unusual I/O condition: A register contains: 
Bit = 1 

Bit 5 = 1 if File Size Overflow 
Bit 6 = 1 if I/O error 
Bit 7 = 1 if End of File 
Bits 18-23 = File number 

5 Interrupt on timeout. The BRS 78 can only disarm, not arm. See BRS 135. 

6 Interrupt on Floating Point Overflow 

7 Interrupt on Floating Point Underflow (Not Implemeted) 

8 Interrupt on Buffer Cleared, but curcuit still valid. 

9 Interrupt on dismiss will occur on CIO, in or out (See BRS 155) 

10 Interrupt on Bad file number for CIO. Could be a zapped curcuit. 

11 Interrupt on Disk Error. Requires System Status to set. 

Example : 

ARM LDA =PANIC; STA 201B (Interrupt Location); LDA =2000000'B 
BRS 78 (ARM FOR PANICS) 

PANIC ZRO PC Save program counter in PC 

Do interrupt routine 

. 

LDA =Z000000B; BRS 78 (RE-AMR) ;BRU* PC 
PC ZRO PC SAVE 

Each time a panic is hit, the code at "PANIC" is executed. 
Instruction traps: None. 

*BRS 80* 

DATE: 71/09/20 

Name: Set page [read only] 

Status : User or Exec 

Input: A= PMT/SMT number 

Output: A= Old status of byte 

B= Preserved 

X= Preserved 
Description: If the sign bit of A is on, the byte will be made read 
only. If the sign bit is off, the byte will be made read-write. 
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Any attempt to store into a read-only page will result in a memory 
trap or take the interrupt if armed. 



Expanded SMT"s 



Only Exec status forks can 
cannot be made read- 



set pages read-write. 

write via the BRS 30. 

Instruction traps: Insufficient status, bad byte number, byte number 

not in use. 



*BRS 81* 

DATE: 71/09/20 

Name: Dismiss for a specified period of time 

Status : User 

Input: A= Numoer of milliseconds to dismiss for 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: The fork is dimmissed for trie number of milliseconds in 
A. The minimum dismissal time is 2 seconds. 



*BRS 82* 

DATE: 71/09/21 

Name: Skip if [floating accumulator] negative 

Status : User 

Input : None 

Output: 



cv 



T-e»+-n yn 






A = Preserved 



X= Preserved 

A= Preserved 

B= Preserved 

X= Preserved 

Skips if the floating accumulators are negative. 
If floating point hardware does not exist, the sign bit of the 
simulated accumulator will be tested. 
Instruction traps: None 

*BRS 83* 



return : 
(failure) 

Description: 



DATE: 

Name: Skip i 

Status: User 

Input : None 

Output : 

Skip return: 

(success) 

return : 
(failure) 

escription: 



71/09/21 

f [floating accumulator] zero 



A= Contents of floating accumulator 
B= Contents of floating accumulator 
X= Preserved 

A= Contents of floating accumulator 
B= Contents of floating accumulator 
X= Preserved 
Skips if the floating accumulators are zero. 



Also 

places the contents of the floating accumulator in A and 3. If 
floating point Hardware does not exist, the simulated accumulator 
will be tested. 
Instruction trans: None 



-43- 



Tymshare BRS Manual BRS'S IN NUMERICAL SEQUENCE 

*BRS 84* 

DATE: 71/09/21 

Name: Skip if [floating accumulator] non-zero 

Status : User 

Input: None 

Output: 

Skip return: A= Contents of floating accumulator 

(success) B= Contents of floating accumulator 

X= Preserved 
return: A= Contents of floating accumulator 
(failure) B= Contents of floating accumulator 

X= Preserved 
Description: Skip if the floating accumulators are non-zero. Also 
places the contents of the floating accumulators in A and B. If 
floating point hardware does not exist, the simulated accumulator 
v;ill be tested. 
Instruction traps : None 

*BRS 85* 

DATE: 71/09/21 

Name: Set 3-level output mode 

Status: User 

Input: X= Port number (-1 , or 1 for command port) 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Sets terminal to [eight-level] output mode, eight bit 
characters to transmitted to the terminal exactly as they are from the 
program. 
Instruction traps: Bad port number in X (unless interrupt 10 is armed). 

*BRS 86* 

DATE: 71/09/21 

Name: Reset G-level output mode 

Status : User 

Input: A= Port number (-1, or 1 for command port) 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Resets [eight-level] mode. Characters are hence forth 
translated by the monitor. 
Instruction traps: Bad port number in X (unless interrupt 10 is armed). 

*BRS 87* 

DATE: 71/07/22 

Name: Convert [port number] to job number 

Status: Subsystem 

Input: X = Port number 

Output: A = Job number (If any) 
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B = Preserved 

X = Preserved 
Description: Converts the port number in X to a job number returned 
in A. 
Instruction traps: Insufficient status 



*BRS 88* 

DATE: 71/09/10 

Name: Read [CPU] time 

Status: User 

Input: None 

Output: A= CPU time in clock ticks (1/G0 second) 

B= Preserved 

X= Preserved 
Description: Reads the CPU time for the job and returns it in A, 
Instruction traps: None 

*BRS 89* 

DATE: 71/09/10 

Name: Read [resource metering] 
Status: User 

Input: A= Address of 6 word buffer to put data 
Output: A= Preserved 
B= Preserved 

Si. — JO J-^OCL V «SV-t 

Description: Reads into the buffer 6 words of resource metering 
described below. 

Word Description 



Disc Use, Number of Disc accesses 

1 Swap Count, Number of times job was swapped 

2 Total number of characters input and output 

3 Page Ticks, 1 Page tick = 1 page/clock tick 

4 CPU time in clock ticks 

5 Number of clock ticks since login 

Instruction traps: None 
*BRS 90* 

DATE: 71/09/10 

Name: Declare fork for [panic] 

Status : User 

Input: A= Preserved 

B= Preserved 

X= Preserved 
Description: Indicates that the current fork is the highest to 
[terminate] if the user types a panic. If the fork which did the BRS 90 
has armed interrupt 1 , the interrupt will be take instead of terminating 
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the fork . 

Instruction traps: None 

*BRS 91* 

DATE: 71/09/10 

Name: Store [date] and [time] into a string 

Status : User 

Input: A= First word of string pointer 

Output: A= Preserved 

B= String point + length of date string 
X= Preserved 
Description: Reads the current date and time into a null string address 
pointed to by A. The resulting string has the form MM/DDSHH:NNSSSS 
where: M= Month 

D= Date 

H= Hours (from 0-23) 

N= Minutes 

S= Space (note: 4 spaces at end) 
Instruction traps: Invalid pointer in A. 

*BRS 9 2* 

DATE: 71/09/10 

Name: Set value of [file size quantum] for all files to be opened 

until logout time 
Status: User 

Input: A= Maximum character count 
Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Sets the physical file size quantum alloted to open 
output files. A must be between 7377B and 20000000B. If A is 
between 3248640D and 20000000B, the maximum quantum is set to 3248640D, 
which is the absolute maximum for all files. The maximum set 
at logon time is 1364000B characters. If the file quantum is dep;eted, 
an instruction trap will occur at the syspop which caused it unless 
interrupt 4 is armed. The SSP syspop overrides the effect of a BRS 92 for 
the file the referenced by the SSP. 

Note: Because of overhead in the file system, physical size is 
usually greater than data size. A one character data file requires 
3 00 0B character of physical space on the disc. Overhead for large 
files is about 3 percent. 
Instruction traps: Bad argument in A. 

*BRS 9 3* 

DATE: 71/09/10 

Name: Reset resource metering 

Status: Exec 

Input: None 

Output: A= Preserved 



■46- 



Tymshare BRS Manual BRS'S IN NUMERICAL SEQUENCE 

B= Preserved 

X= Preserved 
Description: Resets the resource metering counters. 
(See BRS 39) . 
Instruction traps: Insufficient status 

*BPS 94* 

DATE: 71/09/10 

Name: Clear fork structure 

Status: System 

Input: None 

Output: A= Destroyed 

B= Destroyed 

X= Destroyed 
Description: Returns job to the Exec at the instruction following 
the BRS 9. No panic tables are saved. 
Instruction Traps: Insufficient Status 

♦BRS 95* 

DATE: 71/09/10 

Name: Acquire and release [over flow groups] 

Status : Exec 

Input: A= to return next available overflow pointer 

= Overflow pointer to turn on/off bit in bit map 
Output: A= Destroyed or contains next available overflow pointer 

B= Destroyed. 

X= Destroyed. 
Description: If A is 0, then the next available overflow group 
is returned in A. If A is an overflow group (file directories 4000B- 
4377B) , and the sign bit is off, the overflow group is released and 
it's corresponding bit turned off in the bit map. If A is an over- 
flow group and the sign bit is on, the overflow group is taken 
and the bit turned on in the bit map. 
Instruction traps: Insufficient status. 

*BRS 96* 

DATE: 71/09/16 

Name: Read [file attributes] and [file directory] data 

Status: User 

Input: B= Buffer address 

X= Word count 
Output: A= Contents of last word in buffer 

B== Destroyed 

X= Destroyed 
Description: Reads the file attributes and file directory data for 
the last file accessed by an Exec BRS (for example, a BRS 48 or 62) 
into the buffer specified by 3. Data in buffer: 

Word 0: Group number in bits 0-11 

Prime directory in bits 12-23 
Words 1-4: File directory data words (see below) 
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Words 5-N: File name with sign bit on in last word 
File directory data words: 

Word 1 : OAA AAA AAA AAY YYY EEE EDD DDD 



Word 2 
Word 3 
Word 4 



BCO HHH IIHH IIHH FFF FFF FFF FFF 
GGG TTT 000 OIZ XWV USR QNM LKJ 
PPP PPP PPP PPP PPP PPP PPP PPP 



Where : 



A = Access Count 

B = Changed File 

C = Extra Changed File 

B = Creation Day-1 

E = Creation Month- 1 

F = File Size (1 = 256 words) 

G = Good Disc File if 010, BAD if 100 and Init Dummy if 000 

H = Mapping Control 

1 = Init lock Flag 2B4 
J = Init Flag 1 

K = Exec status 2 

L = System Status 4 

n - Subsystem Status 10B 

N = Proprietary 20B 

P = Index Block Pointer 

Q = Account Public 40B 

R = Append Only 1B2 

S = Mot Private Writable 2B2 

T = File Type (From 1-4) 

U = riot Private Read 4B2 

V = Reserved. 

W = Public Write 2B3 

X = Public Remote 4B3 

Y = Creation Year - 196 4 

2 = Premium Charge 1B4 

See tiie BRE 6 for a fuller explanation of these fields. 

Warning: If tae buffer specified does not point to a page somewhere 

in the relabeling, the Exec will place the data in a new page if possible, 

but will not (!!!) affect the user relabeling. 

Instruction traps: .ione 

*BR5 9 7* 

DATE: 71/09/16 

Mane: Reset subsystem counter 

Status: Subsystem 

Input: A= Counter number (0-31) 

B= Value to De set 
Output: A= Preserved 

B= Preserved 
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X= Preserved 
Description: Sets the counter in A to value to B. 
Instruction traps: Insufficient status, bad counter number in A. 

♦BRS 9 8^ 

DATE: 71/09/16 

Name: Increment subsystem counter 

Status : Subsystem 

Input: A= Counter number (0-31) 

B= Number to be added to counter in A 
Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Adds contents of B to the counter in A. 
Instruction traps: Insufficient status, bad counter number in A. 

♦BRS 99 ♦ 

DATE: 71/09/16 

Name: Reads subsystem counter 

Status: Subsystem 

Input: A= Counter number (0-31) 

Output: A= Contents of counter 

B= Preserved 

X= Preserved 
Description: Reads the subsystem counter specified by A. 
Instruction traps: Insufficient status, bad counter in A. 

♦BRS 100* 

DATE: 69/05/13 

FUNCTION: ASSIGNS A DEVICE TO A USER 

STATUS : OPERATOR 

INPUT: A= DEVICE NUMBER 

X= CHANNEL NUMBER OR -1 
DEVICE NUMBERS: 0=TAPE0, 1=TAPE1 , 2=PRINTER 
RETURNS: NO SKIP=ERROR, DEVICE ALREADY ASSIGNED. 

SKIP=NORMAL RETURN 
DESCRIPTION: THE DEVICE IS ASSIGNED TO THE USER. AFTER THAT THE 
USER CAN DRIVE THE DEVICE DIRECTLY USING THE OTHER BRS'S. MAG TAPE 
IS SET TO ODD PARITY. 
ONLY ONE DEVICE CAN BE ASSIGNED AT A TIME. 

♦BRS 101* 

DATE: 69/0 5/13 

FUNCTION: UN ASSIGN DEVICE 

STATUS : OPERATOR 

DESCRIPTIONS: RESETS DEVICE ASSIGNMENT. USER CAN NO LONGER ACCESS 

DEVICE WITH BRS'S. 

REGISTERS AFFECTED: NONE 

♦BRS 102+ 
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DATE: 70/09/20 

FUNCTION: READ [MAG TAPE] 

STATUS : USER 

INPUT: A= CORE BUFFER ADDRESS, B= CORE BUFFER SIZE 

X= NUMBER OF RECORDS ( MAX 64) 
THIS BRS READS MANY RECORDS INTO CORE. IT ASSUMES THAT THE RECORD SIZE 
IS UNKNOWN* IT READS SUCESSIVE RECORDS INTO THE BUFFER AND 
PRECEEDS EACH RECORD WITH A CODE WORD THAT EXPLAINS ABOUT THAT RECORD. 
IN THE NORMAL CASE THE ADDRESS FIELD OF THIS WORD HOLDS THE 

NUMBER OF 9 40 WORDS III THE RECORD. FOR INTERPRETATION OF THE OPCODE FIELDS 
SEE APPENDIX C. THE BUFFER MUST BE ENTIRELY IN ONE PAGE. 

♦BRS 103* 

DATE: 71/06/30 

FUNCTION: WRITE [MAG TAPE] 

STATUS : USER 

INPUT: A= CORE ADDRESS OF DATA IN THE FOLLOWING FORMAT. 

(A) COMMUNICATION FROM SYSTEM TO USER. 

(A)+1 1ST RECORD WORD COUNT 

(A) +2 THROUGH (A)+N+1 RECORD DATA. 

(A)+N+2 NEXT RECORD WORD COUNT. 
ETC. COUNT =0 AFTER LAST RECORD. 

OUTPUT: (A) CONTAINS ADDRESS OF "WORD COUNT" WORD FOR LAST RECORD 
WRITTEN. THE OP CODE OF (A) CONTAINS ONE OF THE FLAGS LISTED UNDER 
APPENDIX C. 

DESCRIPTION: ALL THE DATA AND COMMUNICATIONS WORDS MUST BE III ONE 
PAGE. USER MUST ERASE TAPE AT LOAD POINT AND MAY NOT WRITE 
BEYOND THE REFLECTIVE SPOT EXCEPT FOR END OF FILE MARKS. 
REGISTERS AFFECTED: NONE 

♦BRS 104* 

DATE: 69/05/13 

FUNCTION: REPORTS WHO HAS DEVICE 

STATUS: USER 

OUTPUT: A= DEVICE 

X= CHANNEL 
DESCRIPTION: CAN BE USED TO DETERMINE WHAT W-BUFFER DEVICE IS 
ASSIGNED AND WHAT CHANNEL THE USER IS ON WHO IS USING THE DEVICE. 
DEVICE NUMBERS ARE 0=TAPE 0, 1=TAPE 1, 2=PRINTER. 
A -1 IN THE A REGISTER MEANS NO DEVICE IS ASSIGNED. 
REGISTERS AFFECTED: A,X. 

♦BRS 105* 

DATE: G 9/0 5/31 

FUNCTION: [MAG TAPE] CONTROLS 

STATUS: USER 

INPUT: A= CONTROL NUMBER . 

1= WAIT UNTIL TAPE IS READY 

2= BACKSPACE RECORD 

3= FORWARD SPACE FILE 
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4= BACKSPACE FILE 

5= WRITE 3 INCHES OF BLANK TAPE 

6= REWIND 

7= WRITE END OF FILE. 
OUTPUT: THE OP CODE OF A HAS ONE OF THE FLAGS LISTED UNDER 

APPENDIX C. THE ADDRESS OF A IS DESTROYED. 
REGISTERS AFFECTED: A 

♦BRS 106+ 

DATE: 71/02/03 

FUNCTION: PRINT ON [PRINTER] 

STATUS: USER 

INPUT: A= CORE ADDRESS OF DATA IN THE FOLLOWING FORMAT, X= WORD COUNT 

(A) COMMUNICATION WORD FROM SYSTEM TO USER. SEE APPENDIX C 

(A)+1 PAPER CONTROL. NEG FOR SKIP, POSITIVE FOR UPSPACE. 

(A) +2 - (A) +34 ONE LINE OF DATA IN 6 BIT BCD. 

(A) +35 PAPER CONTROL 
ETC. 

OUTPUT: (A) CONTAINS ONE OF THE OP CODE FLAGS LISTED UNDER BRS 102. 
DESCRIPTION: ALL DATA AND COMMUNICATIONS WORDS MUST BE IN ONE PAGE. 
ALL t LINES MUST BE FULL LENGTH. 

IT IS REQUIRED THAT THE PRINTER BE ASSIGNED TO THE CURRENT JOB. 
IT IS NOT NORMAL OPERATING PROCEDURE TO ASSIGN THE PRINTER TO 
JOBS NOT RUN BY THE OPERATOR. 



♦BRS 107* 

DATE: 69/05/13 

FUNCTION: SET [MAG TAPE] [PARITY] 

STATUS: USER 

INPUT: A IS NEG. FOR [BCD] (EVEN PARITY) . 

A IS POSITIVE FOR BINARY (ODD PARITY) . 
DESCRIPTION: IF THIS BRS IS NOT USED, TAPE WILL BE READ IN BINARY 
REGISTERS AFFECTED: NONE 

♦BRS 108^ 

DATE: 69/05/13 

FUNCTION: TEST [MAG TAPE] [DENSITY] 

STATUS: USER 

OUTPUT: A=0 FOR 200 

A=1 FOR 556 

A=2 FOR 800 
REGISTERS AFFECTED: A 

♦BRS 109* 

DATE: 71/02/06 

FUNCTION : DISMISS 

STATUS : USER 

CALLING SEQUENCE: BRS 109 

DESCRIPTION: THE FORK IS DISMISSED. IT CAN ONLY BE ACTIVATED 
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AGAIN BY A PROGRAM INTERRUPT WHICH HAS BEEN ARMED BY THIS FORK 
OR THE TERMINATION OF A LOWER FORK. 
REGISTERS AFFECTED: NONE 

♦BRS 110* 

DATE: 71/02/03 

FUNCTION: TEST [MAG TAPE] KEADY 
STATUS : USER 

RETURNS: NO SKIP = NOT READY 
SKIP = READY 

*BRS 111* 

DATE: 69/05/13 

FUNCTION: RETURN FROM CLASS 3 BRS 

STATUS : EXEC 

DESCRIPTION: THIS BRS IS USED ONLY BY THE AUTHOR OF CLASS 3 

BRS'S. IT IS THE ONLY NORMAL TERMINATION OF A CLASS 3 BRS. IT 

CORRESPONDS TO A BRS 10 FOR OTHER FORKS. 

INSTRUCTION TRAP: 

BRS ISSUED BY A FORK WHICH WAS NOT A CLASS 3 BRS. 

REGISTERS AFFECTED: NONE 

*BRS 112* 

DATE: 69/05/13 

FUNCTION: REMOVE A JOB FROM THE SYSTEM 

STATUS : EXEC 

INPUT: A= JOB NUMBER 

NO RETURNS 

REGISTERS AFFECTED: ALL 

*BRS 113* 

DATE: 70/01/30 

FUNCTION: DISABLE ESCAPES 

STATUS: USER 

DESCRIPTION: ALLOWS USER TO PREVENT TERMINATION FROM AN ALTMODE 

OR A SHIFT-CONTROL O. IT IS RESET BY A BRS 114 

REGISTERS AFFECTED: NONE 

*BRS 114* 

DATE: 70/01/30 

STATUS : USER 

DESCRIPTION: RESETS THE CONDITION SET BY A BRS 113. 

REGISTERS AFFECTED: NONE 

*BRS 115* 

DATE: 69/05/13 

FUNCTION: TERMINATE CLASS 3 BRS FORK WITH PANIC 

STATUS: EXEC BRS 

DESCRIPTION: TERMINATES THE EXEC BRS AND CAUSES A RU30UT FOR THE JOB. 
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REGISTERS AFFECTED: NONE 

*BRS 116* 

DATE: 69/05/13 

FUNCTION: READ PROGRAM RELABELING 

STATUS: USER 

OUTPUT: A,B = PROGRAM PSEUDO- RELABELING. 

DESCRIPTION: PUTS THE PROGRAM RELABELING INTO A AND B. THIS 

IS WHAT THE SYSTEM EXECUTIVE USES AS PROGRAM RELABELING. IT 

IS KEPT IN THE TS BLOCK. 

REGISTERS AFFECTED: A, B 

♦BRS 117* 

DATE: 69/05/13 

FUNCTION: SET PROGRAM RELABELING 

STATUS: USER 

INPUT: A, 3= THE NEW VALUES FOR THE PROGRAM RELABELING 

DESCRIPTION: SETS THE PROGRAM RELABELING IN THE TS BLOCK AS 

SPECIFIED. USER PROGRAMS SHOULD USE BRS 44 TO SET RELABELING 

FOR A FORK. 

INSTRUCTION TRAP: 

1) A SPECIFIED RELABELING BYTE WAS NOT ASSIGNED. 

2) A USER FORK TRIED TO RELABEL A SYSTEM BYTE, 

THIS IS THE PROGRAM RELABELING TYPED BY THE STATUS COMMAND, IT 
SHOULD CORRESPOND TO THE RELABELING OF THE FIRST NON-SUBSYSTEM 
FORK BELOW THE EXECUTIVE. IF THE FORK IS RUNNING UNDER DDT, 
DDT WILL UPDATE THIS RELABELING. OTHERWISE, IT IS THE RESPON- 
SIBILITY OF THE USER. IT IS PARTICULARLY IMPORTANT THAT THIS 
RELABELING BE SET CORRECTLY BEFORE ISSUING A DUMP COMMAND. 

REGISTERS AFFECTED: NONE 

*BRS 118* 

DATE: 70/07/05 

FUNCTION: LOAD FLOATING ACCUMULATOR FROM A S B 

STATUS : USER 

DESCRIPTION: LOADS THE FLOATING ACCUMULATOR FROM THE A AND B 

REGISTERS. IF FLOATING POINT HARDWARE IS NOT IMPLEMENTED, THE SIMULATED 

ACCUMULATORS WILL BE SET. 

REGISTERS AFFECTED: NONE 

*BRS 119* 

DATE: 70/07/05 

FUNCTION: STORE FLOATING ACCUMULATOR INTO A £ B 

STATUS: USER 

DESCRIPTION: STORES THE CONTENTS OF THE FLOATING ACCUMALTORS 

INTO REGISTERS A AND B. IF FLOATING POINT HARDWARE IS NOT IMPLEMENTED, 

THE SIMULATED ACCUMULATORS WILL BE READ INTO A AND B. 

REGISTERS AFFECTED: A,B 
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*BRS 130* 

DATE: 69/05/13 

FUNCTION: TEST A BREAKPOINT SWITCH 

STATUS : SUBSYSTEM 

CALLING SEQUENCE: LBX ^SWITCH NUMBER 

BRS 1 30 

SWITCH UP RETURN 

SWITCH DOWN RETURN 
DESCRIPTION: TESTS THE BREAKPOINT SWITCH (1,2,3,4) INDICATED 
IN X. IF THE SWITCH IS DOWN, THE BRS SKIPS ON RETURN. 
REGISTERS AFFECTED: NONE 

♦BRS 131* 

DATE: 69/05/13 

FUNCTION: TO CRASH THE SYSTEM 

STATUS : EXEC 

NO RETURN 

DESCRIPTION: SAVES THE REGISTERS IN SS01 , SS02, SS03. SAVES 

IN MCRO. TURNS OFF THE CLOCK AND DISABLES THE INTERRUPTS. 

MOVES THE TS BLOCK INTO REAL PAGE 14. 

REGISTERS AFFECTED: NONE 

*BRS 132* 

DATE: 71/0 7/23 

Name: Read Terminal Characteristics 

Status: User 

Input: X = or - 1 for user's [Command Port] 

or (Port/2-10) for port number 
Output: A = [Terminal Characteristics] 

B = Preserved 

X = Preserved 
Description: Reads terminal characteristics and returns them in A. If 
X contains an invalid port number, and interrupt 10 is armed, the interrupt 
will be taken. The terminal characteristics are derived from the 
table below: 

Byte (Bits 0-3) 

Bit = Can Echo 

Bit 1 = Echo Control I 

Bit 2 = Echo CR Rubout to LF 

Bit 3 = Echo LF to CR 

Byte 1 (Bits 4-7) 

Bit = CR Delay 
Bit 1 = ] 

Bit 2 = ] Input baud Rate 



-54- 



Tymshare BRS Manual BRS'S IN NUMERICAL SEQUENCE 

Bit 3 = ] 

Byte 2 (Bits 8-1 1) 

Bit = ] 

Bit 1 = ] Output baud Rate 

Bit 2 = ] 

Bit 3 = Requires Parity (1 for on) 

Byte 3 (Bits 12-15) 

Bit = ] 

Bit 1 = ] Parameter "A" (See Below) 

Bit 2 == ] 

Bit 3 = Half Duplex (1 for on) 

Byte 4 (Bits 16-19) 

Bit = ] 

Bit 1 = ] Parameter "B" (See Below) 

Bit 2 = ] 

Bit 3 = Not Used 

Byte 5 (Bits 20-23) 

Bit = ] 

Bit 1 = ] Parameter 

Bit 2 = ] M C" 

Bit 3 = ] 

Both the Input and Output baud rates are calculated by an index into 
a table of aaud rates. To arrive at this index, take the desired baud 
rate and divide it into 4800, that is: (4800/Baud Rate)= N. 
N is then compared for the closest match in the following table: 

Index "N" 






54B 


[110 


Baud] 


1 


40B 


[150 


Baud] 


2 


20B 


[300 


Baud] 


3 


14B 






4 


10B 






5 


4B 






6 


4B 






7 


4B 







The "A",'^" and "C" parameters are what determine both the speed 
of the terminal and the carriage return delay. If the terminal is a Line fee 
delay terminal, then the delay is calculated by the following algorithm: 
If n=1, then F(n)= M A" else if "C" n, then F(n)=C-n+B else F(n)=B. 



-55- 



Tymshare BRS Manual BRS'S IN NUMERICAL SEQUENCE 

where n is the number of characters in a line to be output. 

If the terminal is a Carriage Return Delay device (Bit of Byte 1) , 

then the delay is calculated as thus: F (n)=Min[n/ (2**A) ]+B,C 

The "C M parameter is calculated by an index into the following table: 



dex 


CPARAM 





10D 


1 


UD 


2 


19D 


3 


26D 


4 


36D 


5 


50D 


6 


69D 


7 


95D 





131D 



Each terminal when it is logged in has it's terminal characteristics 
set by the Exec. The following is a list of the Identifying Characters 
and their parameters : 

ID Terminal Characteristics 



A 


56440000B 


C 


56444307B 


E 


56444146B 


G 


54442013B 


B 


56220000B 


F 


56244307B 


J 


56230000B 


N 


56244146B 


CR 


56000000B 


D 


56000000B 



The only difference between the CR and D identifier is that the 
remote knows the differences. Therefore, a terminal cannot change into 
a 2741 and back again. Only a 2741 can change and return to it's original 
state. 

Instruction Traps: Invalid port number (If interrupt 10 is not armed). 

*BRS 134* 

DATE: 71/0 8/24 

Name: Read in characters in "[Paper Tape mode]" 

Status: User 

Input: None 

Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: This BRS is no longer functional. It presently is 
a NOP. Programs using this BRS should do their own routines 
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to read in characters and test for linefeed before carriage 
return and vice versa. 
Instruction Traps: None 

*BRS 135* 

DATE: 71/09/22 

FUNCTION: INTERRUPTS A FORK AFTER A SPECIFIED PERIOD OF [TIME] 

STATUS: USER 

A= THE NEW [INTERRUPT] MASK. 

DESCRIPTION: THE FORK ISSUING THIS BRS WILL BE INTERRUPTED 

AFTER THE DELAY IF INTERRUPT NUMBER 5 IS ARMED AT THAT TIME. 

INTERRUPT WILL BE TERMINATED. THE BRS 78 DISARMS THE BRS 135. ALSO 

SEE THE BRS 81. 

REGISTERS AFFECTED: NONE 

*BRS 136* 

DATE: 71/09/22 

FUNCTION: SETS SYSTEM EXEC SWITCHES IN SYMS 

STATUS : EXEC 

CALLING SEQUENCE: LDA V 

LDX N 

BRS 136 

NORMAL RETURN 
V = NEW SWITCH VALUE 
N = SWITCH NUMBER 
DESCRIPTION: THE SWITCH IS SET TO THE NEW VALUE AND THE OLD 
VALUE IS RETURNED IN A. TABLE OF SWITCHES: 

X Description of Switch 



SWEX. Exec Switch 

1 SWLET. Letter Routine Switch 

2 PACST. 

3 Zero Cell. Not Used. 

4 AC A. Accounting Area 

5 DOWN. No longer referenced by Monitor or Exec. 

6 FATIG. Minned by Monitor if REAL is about to overflow 

7 SWMBL. Mail Box List Busy 

8 SWMBM. Mail Box Messages Busy 

9 ENMSK. Subsystem Enable Mask. No longer referenced by Monitor or Exec 
10 SWFD. File Directory Busy for user specified. 

REGISTERS AFFECTED: A 

*BRS 137* 

DATE: 71/0 7/23 

Name: List [port numbers] in memory 

Status : User 

Input: X = Address in user's page where table is to be put. 

Output: A = Lengtn of list 
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B = Preserved 

X = Preserved 
Description: Lists his command port (0) in the head of the list, 
Auxilary ports are then appended to the list. 
Instruction Traps: None 

♦BRS 138* 

DATE: 71/07/23 

Name: [Supervisor] Request 

Status : Exec 

Input : None 

Output: A = Error Number (If any) 

B = Preserved 

X = Auxilary [Port] number 
Description: Places a request on the Supervisor (See Appendix H) 
to get an [auxilary circuit] . The monitor dismisses the user until 
the Supervisor sets up a circuit to the user's program. The user cannot 
shift control O out of this condition until the BRS 138 returns. The user 
then outputs to the teletype (File number 1), a login string. This string 
must be terminated by a dash. 

Supervisor Error Table 



C(A) = 1 = Format Error 

2 = Bad User Name 

3 = Bad MUD 

4 = System Unavailable 



Example: To log in under the user name "FALSENAME" on computer 25: 
LOGIN BRS 138; SKE =0; HLT (Impossible) ; LDP LOGPTR 

LDX =1; BRS 35; BRS 138; SKE =0; BRU ERROR 

STX IF; EAX 1,2; STX OF; ... 
LOGPTR DATA 3*LOGSTR-1 ,3*LOGSTR+1 2 
LOGSTR ASC * FALSENAME: 2 5- • 

This string is sent to the Supervisor which attempts to find this user in 

the [MUD]. Another BRS 138 is then done and will return an error code 

in A. If A is zero, then no errors have occurred and the auxilary port 

number can be found in X. Notice: The port number in X is the input 

port. The output port is found by adding 1 to X. The port number 

in X can now be used by the character SYSPOPS and BRS's (CIO, CIT, BRS 

35, 33 etc.) 

Instruction Traps: Insufficient status 

♦BRS 139* 

DATE: 71/07/27 

Name: [Sap] an [auxilary circuit] 
Status: User 

Input: X = [Input port] number (As returned by BRS 138) 
Output: A = Preserved 
B = Preserved 
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X = Preserved 
Description: Zaps the auxilary circuit (Removes it from Tymnet) . 
Instruction Trap: Invalid port number in X. 

*BRS 140* 

DATE: 71/03/24 

FUNCTION: READS THE DATE INCLUDING THE YEAR INTO THE USERS MEMORY 

STATUS: USER 

INPUT: A=BEGINNING STRING POINTER 

BLENDING STRING POINTER 
DESCRIPTION: THE CURRENT DATE AND TIME ARE APPENDED TO THE 
STRING PROVIDED IN A AND B REGISTERS AND THE RESULTING STRING 
POINTERS ARE RETURNED IN THE A AND B REGISTERS. THE CHARACTERS 
APPENDED TO THE STRING HAVE THE FORM: 
MM/DD/YY HH:MM 

MM=MONTH 

DD=DAY 

YY=YEAR 

HH=IIOURS COUNTED FROM TO 24 

MM=MINUTES . 
SEE BRS 91 
REGISTERS AFFECTED: B 

*BRS 141* 

DATE: 71/09/22 

FUNCTION': GETS EXEC SUBROUTINES 

STATUS : EXEC 

DESCRIPTION: CHECKS THAT THE ISSUING FORK HAS EXEC STATUS. 

IF IT DOES, AN EXEC BRS IS ISSUED. THIS BRS IS USED TO ALLOW 

EXEC STATUS FORKS TO ACCESS SUBROUTINES IN THE EXEC. TABLE: 

X Description of Routine 



Turns Letter on for All current users. 

1 Super GFD. A = File Directory Number 

2 Set switch to force Exit if negative. A = Switch Value 

3 Counts numDer of users on system. Returns A = NU 

4 Not Used. 

5 Checks for User on system. A = User number 

6 Checks for Operator Timeout. Skips if Still Pending 

7 Set File Group Busy. A = File Directory Group Number 

8 Reads last Ercode. 

9 Changes Index Block Pointer with new pointer in A. Deletes old. 

10 Writes Accounting 

11 Change EXFLAG. 

12 Set File Parameters from A and Date in B. 

REGISTERS AFFECTED: NONE 

*BRS 142* 
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DATE: 71/03/25 

FUNCTION: ALLOWS USER EXECUTION OF EXEC COMMAND 

STATUS: USER 

INPUT: A = FIRST 3 CHARACTERS OF EXEC COMMAND OR SUB-SYS. NAME (OR) 

A = SAME AS ABOVE WITH SIGN BIT (RETURN TO BRS) 
NO OUTPUT 

RETURN: NO RETURN WITH FIRST OPTION (NO SIGN BIT) 
RETURNS: NO SKIP: ILLEGAL COMMAND TO RETURN 

SKIP: COMMAND EXECUTED 
DESCRIPTION: GENERAL 

THE FIRST 3 CHARACTERS OF THE COMMAND OR SUB-SYSTEM NAME ARE 
PLACED IN THE "A" REGISTER. IT ALWAYS APPEARS TO THE EXEC THAT 
THE COMMAND WAS TERMINATED BY A CARRIAGE -RE TURN. COMMAND ARGUMENTS 
ARE TAKEN FROM THE TELETYPE OR THE COMMANDS-FROM FILE. THE USUAL 
PROMPTING MESSAGES ARE TYPED. 
DESCRIPTION: NO SIGN BIT IN "A" 

ALL COMMANDS ARE LEGAL. THE EXEC DOES A RESET BEFORE EXECUTING 
THE COMMAND. THE COMMAND IS EXECUTED AS IF IT WAS TYPED IN THE EXEC 
TERMINATED BY A CARRIAGE RETURN. 
DESCRIPTION: SIGN BIT IN "A" 

ONLY COMMANDS THAT DO NOT NORMALLY DO A RESET ARE LEGAL. THE 
ILLEGAL COMMANDS (SUCH AS LOGOUT, RESET, RUN, CALL SUB-SYSTEM, ETC.) 
WILL CAUSE THE ERROR RETURN (NO SKIP) TO BE TAKEN. "ESCAPES" 
DURING THE EXECUTION OF THE PROGRAM WILL USUALLY CAUSE A RETURN 
TO THE BRS WITH A SKIP. 

*BRS 143* 

DATE: 70/07/06 

FUNCTION: SKIP IF BIT MAP SET 
STATUS: SYSTEM 

DESCRIPTION: SKIPS IF SDBM8 IS ZERO (BIT MAP SET). 
RETURNS: SKIP RETURN = BIT MAP SET 
NO SKIP = BIT MAP NOT SET 
REGISTERS AFFECTED: NONE 

*BRS 144* 

DATE: 6 9/05/13 
FUNCTION: GETS A BUFFER 
STATUS : EXEC 

OUTPUT: A = ADDRESS OF DATA AREA IN BUFFER. 
RETURNS: NO SKIP: NO FREE BUFFERS 
SKIP: NORMAL RETURN 

*BRS 145* 

DATE: 69/05/13 

FUNCTION: RETUIINS A BUFFER 

STATUS : EXEC 

INPUT: A = ADDRESS OF DATA AREA IN BUFFER TO BE RETURNED 

DESCRIPTION: RETURNS THE BUFFER TO THE MONITOR. 

REGISTERS AFFECTED: NONE 
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*BRS 146* 

DATE: 71/03/11 

FUNCTION: READS NUMBER OF QUEUE ENTRIES 

STATUS: SYSTEM 

OUTPUT: A=NUMBER OF JOBS ON QTI, B=NUMBER OF JOBS ON QIO, 

X=NUMBER OF JOBS ON QQE 
DESCRIPTION: THIS BRS WILL BE CHANGED SOON SO THAT THE SIGN 
BIT OF A WILL BE ONE IF THERE IS A JOB ON QQC. 
REGISTERS AFFECTED: ALL 
*BRS 147* 

DATE: 69/05/13 

FUNCTION: [CLOSE] S ALL EXCEPT COMMANDS-FROM [FILE] 

STATUS : USER 

REGISTERS AFFECTED: NONE 

*BRS 148* 

DATE: 70/07/06 

FUNCTION: NEGATE FLOATING ACCUMULATOR 
STATUS : USER 

DESCRIPTION: THE CURRENT CONTENTS OF THE FLOATING ACCUMULATOR ARE 
NEGATED. OVERFLOW WILL CAUSE THE OVERFLOW INDICATOR TO BE SET. 
IF FLOATING POINT HARDWARE IS NOT IMPLEMENTED, THE SIMULATED ACC- 
UMULATORS WILL BE NEGATED. 
REGISTERS AFFECTED : NONE 

*BRS 149* 

DATE: 70/07/06 

FUNCTION: FIX FLOATING ACCUMULATOR AND STORE IN A £ B 

STATUS: USER 

DESCRIPTION: FIX THE FLOATING ACCUMULAORS AND PLACE IN A AND B. 

THE NUMBER IN THE FLOATING ACCUMULATOR IS CONVERTED TO A INTEGER 

AND STORED IN THE A REGISTER. 

REGISTERS AFFECTED: A 

♦BRS 150* 

DATE: 70/07/06 

FUNCTION: FLOAT A £ B AND PLACE IN THE FLOATING ACCUMULATOR 

STATUS : USER 

DESCRIPTION: THE NUMBER IN A AND 3 IS CONVERTED TO A FLOATING POINT 

NUMBER AND STORED IN THE FLOATING ACCUMULATOR. 

REGISTERS AFFECTED: B 

♦BRS 151* 

DATE: 71/03/25 

FUNCTION: CHANGE COMMANDS-FROM FILE 

STATUS : USER 

INPUT: A = FILE NUMBER OF COMMANDS-FROM FILE. 

DESCRIPTION: CLOSES THE COMMANDS-FROM FILE IF ONE IS OPEN AND 
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SETS THE COMMANDS-FROM FILE TO THE FILE SPECIFIED IN A. 
THIS BRS WORKS IN CONJUNCTION WITH THE EXEC "COMMANDS" COMMAND WHICH 
OPENS A FILE FOR INPUT AND CAUSES ALL EXEC INPUT TO COME FROM THIS 
FILE. THE FILE NUMBER IS PASSED TO SUB-SYSTEMS AND GOTO PROGRAMS 
IN THE "A" REGISTER* SEE ALL BRS 77 FOR TELETYPE-OUTPUT CONTROL. 
REGISTERS AFFECTED: NONE SAVED 

*BRS 153* 

DATE: 70/0 7/27 
Name: Set cell 211 
Status : User 

A = Page of [Supervisor] 

A = Preserved 

B = Preserved 

X = Preserved 

Sets cell [21 1B] to page zero of the Supervisor, This can 
only be done by the Supervisor. 
Instruction Traps: User not Supervisor, 



Input: 
Output: 



Description: 



211 not zero. 



*BRS 154* 

DATE: 70/07/27 
Name: Reset cell 211 
Status : User 
Input : None 
Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Sets [2 1 1B] to and unlocks the page. 
Instruction Traps: User not [Supervisor] or 211 already zero. 

*BRS 155* 

DATE: 70/07/27 

Name: Test [port] for characters 
Status: User 
Input: X = port number 
Output: 

Skip return: A = Preserved 
B = Preserved 
X = Preserved 
Return: A = Preserved 

B = Preserved 

X = Preserved 
Description: The BRS will skip: 

1) If the port is an [input port], if there are any characters in 
the input buffer. 

2) If the port is an [output port] , if a TCO would cause a dismiss 
Instruction Trap: Illegal port number. 

*BRS 156* 

DATE: 70/07/27 
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Name: [Zap] all [Auxilary circuits] 

Status : User 

Input : None 

Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Zaps (See Appendix H) all auxilary circuits this job. 
Instruction Traps: None 

*BRS 157* 



DATE: 
Name: 
Status 
Input : 



70/07/27 

Copy [Level 3] [Index Block] to memory 
System 



A = File number 

X = Address in user's memory 
Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Copies the current level 3 index block from the file 
whose file number in in A to user's memory. 

Instruction Traps: Insufficient status, file not opened, unrecoverable 
error. 



*BRS 153* 



nTimp. "71 /m/i7 



Name: Charge [royalty units] 
Status: User 

Input: A = number of units to charge 
Output: Skip return: A = Preserved 

B = Preserved 

X = Preserved 
Return: A = Preserved 

B = Preserved 

X = Preserved 
Description: Adds the number of units in A to the current royalty charge. 
If an overflow occurs or a negative number is given, then non-skip return 
will be taken. 1 Royalty unit = $.001 
Instruction Traps: None 

*BRS 159* 

DATE: 71/0 7/27 

Name: [Answer] lines 

Status : Exec 

Input: A = to "shut" the system (close all lines) 

= 1 to "up" the system (answer all lines) 
Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Answers or shut lines to system. 
Instruction Traps: Insufficient status. 
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*BRS 160* 

DATE: 71/07/27 

Name: Change [terminal characteristics] 
Status: User 

Input: A = New terminal characteristics (see BRS 132 for list of charac- 
teristics) 

X = Port number (-1 for command port) 
Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Changes the characteristics of the terminal. A 
one in a bit position is ON, a zero is OFF. 
Instruction Traps: Bad port number (if interrupt 10 is not armed). 

♦BRS 161* 

DATE: 71/0 7/27 

Name: Ignore Panics 

Status : User 

Input: X = Port number (-1 for command port) 

Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Disables escapes for the port in X. Panics are not 
stacked. 
Instruction Traps: Bad port number (if interrupt 10 is not armed). 

♦BRS 162* 

DATE: 71/0 7/27 

Name: Enable Panics 

Status : User 

Input: X = Port number (-1 for command port) 

Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Reset escape control set by BRS 161. 
Instruction Traps: Bad port number (if interrupt 10 is not armed). 

♦BRS 163* 

DATE: 71/0 7/27 

Name: Copy Net to User 

Status: System 

Input : None 

Output: A = Preserved 

B = Preserved 

X = Preserved 
Description: Copies TYMNET (page 12) to users memory starting at 34000B. 
Instruction Traps: Insufficient status 

*BRS 164* 
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DATE: 71/0 7/27 

Name: Dismiss until [output buffer] empty and/or activate user after 
a period of time. 
Status : User 

Input: A= Number of millisecond to activate at if [Yellow Ball] doesn't 
return. 

X= Port number (-1 for command port) 
Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Sends a yellow ball and waits for it to return, signifying 
that the output buffer is empty. If the yellow ball does not return after 
A milliseconds, then the user is again activated. This BRS is recommended 
over the BRS 14 . 
Instruction traps: Bad port number (if .interrupt 10 is not armed). 



*BRS 166* 




DATE: 71/09/10 




Name : Hang port 




Status : Exec 




Input: A= Same as 


input 


B = Same as 


-i nnnf 


y= Same as 


-l nnn +- 



Description : Hangs port (zero) . The BRS 129 will not allow port 

to be hung. 

Instruction traps: Insufficient status. 

*BRS 167* 

DATE: 71.09.21 

Name: Read and reset disk error flag 
Status i User 
Input : None 

Skip return: A= Preserved 

(success) B= Preserved 

X= Preserved 
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return: A= Preserved 
(failure) B= Preserved 
X= Preserved 
Description: Tests for a disc error caused by a BRS 122, 123, 124, or 129 s . 
The BRS will skip if there were errors since the last time the BRS was 
issued. 
Instruction traps : None 

*BRS 168* 

DATE: 71/09/16 

Name : Disable [shift control 0] 

Status : User 

Input: X= Port number (-1, or 1 for command port) 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Disables shift control O's (oh), but allows panics to 
still be active. 

Instruction traps: Illegal port number in X (takes interrupt 10 if 
armed) . 

*BRS 169* 

DATE: 71/09/16 

Name: Re-arm [shift control O] 

Status: User 

Input: X= Port number (-1, or 1 for command port) 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Re-arms shift control O's. They will now clear forks to 
the Exec . 
Instruction traps: None 

*BRS 170* 

DATE: 71/09/21 

Name: Set limit for [premium charge J program charges 

Status : User 

Input: None 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Calls on the Exec to set the maximum premium charge. When 
the BRS is done, the Exec will type "Please Type Maximum Royalty Program 
Charges You Will Permit:". At that time, the user must input the maximum 
number of charge units. One royalty unit equals $0,001. There is a 
maximum limit of $16,777 of Royalty charges per logon. This is in addition 
to Tymshare' s resource charging (CRU and Connect). 

NOTE: A premium charge program cannot charge until it does BRS 170. 
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*BRS 171* 

DATE: 71/09/21 

Name: Identify [premium charge] program 

Status: User 

Input: A= Premium charge program number 

Output: A= Preserved 

B= Preserved 

X= Preserved 
Description: Each premium charge program is assigned an identity num- 
ber. When the Exec starts the program, the ident is written to the 
accounting. Tymshare will pay the author of the program when the bills 
sent by Tymshare have been paid. 
Instruction traps: None 

*BRS 172* 



DATE: 
Name: 
Status 
Input : 



71/09/21 

Send control information to remote 

User 

A= Special character 

X= Port number (-1 , or 1 for command port) 



T2— TJvcicckVTTtirl 



X= Preserved 
Description: Sends type 1 record through [Tymnet] to 
remote. (See Appendix H) . The A register contains a special 
character which can set terminal characteristics etc. 
Instruction traps: Bad port number in X (takes interrupt 10 if armed) . 
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SECTION 6.0 APPENDIX A 

*BRS 7 TABLES* 

DATE: 71/09/17 

Description of the Miscellaneous table as typed by 1 COUNT: 

Pwfl Power Failures 

Mapnum Map Number 

Dbits Number of Disc blocks remaining 

RS Number of RAD channel errors 

Tnictr Number of teletype "on" interrupts 

Tfictr Number of teletype "off" interrupts 

Spare 1 First Monitor Spare 

Spare2 Second Monitor Spare 

Tiictr Number of teletype input interrupts 

Tiibad Bad channel on input interrupt 

Toictr Number of teletype output interrupts 

Toibad Bad channel output interrupt 

Nu Number of teletypes on 

Utime Number of user on seconds 

Real Number of clock ticks 

Wettb Time not used to speed up disk I/O 

Settb Unsold time (Time used by system) 

Stime Time in system mode 

Spt Page tick for all users 

Pages Pages swapped 

Sswc Swap count for all users 

Rpage Pages read 

Pagew Pages written 

Sdskmt Disk access units for all users 

Armot Arm Motion 

XBerr Index block errors while setting map 

FDerr File Directory errors while setting map 

Extpu Extra Piiantom User entries at BRS 112 

NB112 Number of logouts 

Rber Runout error on Phantom User 

UpShut Contains 1 if "shut", 2 if "up". 

Chrdy Cte channel not ready 

Lcdfib Lost characters due to full input buffer 

Eqpt Equipment cell 

The symbols DO through D5 are counters used for experimentation 
only. Eqpt has the following significance: 

8 = Dual Data Products Disc 

4 = 2314 

2 = Phase II (Tymnet) 

1 = Floating Point Hardware 

Description of the RAD error table: 

If a write error has occurred, the sign bit will be set. The monitor 
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error ta^le RAERL has space for recording 20 D RAD errors. 
A RAD error is one of two types. If the low order 5 bits are 
equal to 35B, the error is a channel error (RC) , otherwise 
the error word is the first half of an addressing error (RA) . 
If the error is an addressing error, the first word is the address 
the monitor attempted. The second word is the address the monitor 
got. If the error is a channel error, the error word will be the POT 
word, and hence no conversion is needed. 

Format of the RAD addressing error word: 

KNN NNN NNN NRR RRR UUW WWW WWW 

Where: 

K = Read/Write key. 1 for Write, for Read 

N = Not used 

R = High order 5 bits of POT word 

U = User Data 

W = Write Count 

Description of the Disc Error table 
If the Disc is a IBM 2314: 

SSS PPP CCC CCC CCH HHH HRR RDD 
Where : 

S = Checksum (First 3 bits only) 

P = Pack Number 

C = Cylinder 

H = Head 

R = Record 

D = Bits used for data chaining 

If the disc is a Data Products: 

NNN NND DDD DDT TTT TTT TSS SSS 

Where : 

N = Not used 

D = Physical disc number 

T = Logical track pair 

S = Sector 

The monitor has space for 10D Disc errors. 

Description of QTIGO: 

Each counter counts the number of swaps per activation condition 
as follows: 
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1 Dismiss until more room on the ring (TROSW) 

2 Not Used. 

3 Teletype early warning (Output buffer) 

4 Special test (Wait for tape clear) 

5 Not used. 

6 Input buffer, BRS 81, BRS 45 or BRS 164 Dismissal 

7 Special fork not on queues. 

Address: 

Dead 

1 Running 

2 BRS 31. Dismiss until lower fork panics 

3 Uncorrectable RAD errors 

4 Exec BRS 

5 BRS 109. Dismiss until off interrupt 

6 BRS 9 

10 Disc use/W Buffer 

1 1 Not used. 

1 2 Wait for unit to clear 

13 Not used. 

14 Exec BRS 

15 BRS 9 

16 Quantum Overflow 

17 Not Used. 

20 Exec level panic 

21 Ordinary panic 

22 3 sec w Buffer time out/Disc errors 

23 BRS 111 

24 BRS 44 

25 Count for BRS 44 

26 Count for RFK 

27 Compute Job count 

30 PU Count 

31 Not Used. 

32 Supervisor Request (Type 5 Out) 

33 Tape read and Printer 

34 Not Used. 

35 TRAPT 

Description of Multiplexer Communication Words: 

The base communicates with the 940 through 6 cells following 21 0B. 
These cells contain the following: 

21 0B ALARM (See description below) 

21 1B Supervisor's page zero. When the Supervisor is running, 
the Supervisor does a BRS 153 to lock his page zero 
in core. The monitor then places the pages' s RMT 
number in 21 1B for the base to put data in. Cell 21 1B 
is non zero both when the Supervisor is running and when 
the Supervisor is awake and trying to take over the net. 
The Supervisor does a BRS 154 to release his page zero 
when he goes to sleep. 

212B+ UP flags. The base clobbers these flags every once in a while 

213B and checks them a few clock ticks later. If the 9 40 has not 



■70- 



Tymshare BRS Manual APPENDIX A 

reset the flags, the base presumes the 940 is down and sends 

a message to the Supervisor telling it so. The keys is 40516337B 

and 51506262B. 

21 4B This cell contains the BRM to the clock interrupt routine in 

the base. 
215B Cell 215B contains a BRM MOHCR. 

Description of the Global File Flags: 

Both the Global flag and the Index Block Pointer array are indexed 
by a global file number. This global file number is not to be confused 
with the local file number associated with each user. Each file open 
on the system is assigned a global file number and a global index 
block pointer. The index into one table is the same as the other. 

DDD DDD DFF IJJ JJJ JPP PPP PPP 

Where: 

D = Initalized to -1. Incremented for each Disc job started, 

Decremented by the interrupt routine 
F = Local File number - 3 
I = Error detected in IDM 
J = Job number 
P = Privelege Flags for file. (High Order 8 bits only) . These are 

tiie random file flags. 

Description of the Job to Teletype Conversion table: 

This table is referenced by a job number which will return the 
following parameters: 

DDD DDD Dim NNN TRP EEE CCC CCC 

Where : 

D = Disc or W buffer busy 

N = Not Used. 

T = Termination pending 

R = User Rubout 

P = PUTIM busy. (Time out interrupt going) 

E = RAD errors 

C = Teletype number 

Description of ALARM: 

ALARM is location 21 OB in the 940 monitor. Whenever a bit is set, the 
Varian 620/1 will howl until that bit is reset. The following is a 
list of bits currently in use: 

Bit 23: Real about to overflow 

Bit 22: Disc map almost/completely filled. 
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Description of the Global Index Block Pointers : 

Each file has a index block associated with it. When that file is opened, 
it's index block pointer is placed in this array. This index block 
pointer is not the same as the one in the file directory however. The 
index block pointer in the file directory is shifted to the right two (2) 
places. Therefore, to convert from a file index block pointer, 
tiie program must do a LSH 2 on the file directory index block pointer. 

Description of DSCTOP: 

DECTOP is the highest disc address that any BRS 122, 123, 
124 or 125 can access. 

Description of MACH: 

MACH is the machine number. Machine numbers have the folloing 
format: (Location) (Machine number) . The locations can have 
the following letters: C Cupertino, California 

II Englewood, Mew Jersey 

P Paris, France (CEGOS) 

Description of STACT: 

STACT is a two v/ord array that contains the beginning and 
current cursor of the Raw Accounting file. 

Description of the WERIS table: (Port) 

With the exception of auxilary ports, the WERIS ta^le contains 
the LUD locators for each port. These locators of of use when look- 
ing up information shuch as User Names and Account numbers. 

Description of the PMTP table: (Job) 

The PMTP table is a list of the locations in the monitor where each job 

has it's "Pseudo Memory Table". At the present time, each job lias 

35 octal entries in the table. The first entry in the table is the 

TS page, followed by page 44B and so forth. The PMTP table points 

to the PMT table for each job. Each PMT entry has the following format: 



SER PPP PPP AAA AAA AAA ACC CCC 



Where 



S = The page is or has been shared (Via BRS 3) 

E = An exec page. This require Exec status to relabel 

over. 
R = Read Only. Set to 1 if Read Only 
A = RAD Address 
C = Code Page (See RMT) 

Description of the CPARW table: (Job) 
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This table contains the Control Parameters for each job. for 
a complete description of the bit fields, see the BRS 39. 

Description of the AUNN table: (Job) 

This table contains the universal user number for each 

job. This is an antiquated table, with the exception of looking 

up information on Auxilary Ports . 

Description of the FGLIST table: (Job) 

This table contains the last file directory accessed for each 
job. This is sometimes reset to zero by the Exec. 

Description of the Miscellaneous Monitor Table (Table no.) 

This table contains many miscellaneous monitor switches and other 
interesting data. The following is a list of the counters in sequential 
order : 

ADRSMT Address of SMT in the monitor 

AEXSMT Address of EXSMT in the monitor 

M48K -1 for 48K, for 64K of memory 

MaxNU Maximum Job Limit 

SDBM8 -1 if Bit Map not set, if set 

MapBit A bit which is redundant to MapNum 

DRC Constant used by monitor to locate Exec on the disc 

SW1 6 -1 if 16 Disc system, if 32 or greater disc system 

RWD if Disc Write Protected 

RWR if RAD Write Protected 

SW205 if 205 interrupt not high 

SWXMA Used by 205 interrupt 

Mach Machine dumber (See Mach above) 

DisclJ Disc number of currently running system 

Vers Versiion of the monitor (2 Words) 

FG940A First Word of Up flags for Base 

FG9 40B Second Word of Up Flags for Base 

Description of RAFR: 

RAFR is a 32 word array that contains the RAD bit map. If a bit is on, the 
page is available for use. 

Description of the ETTB table: (Job) 

ETTB contains the pure compute time for each job in clock ticks. 

Description of the PTCKS table: (Job) 

PTCKS contains the amount of pages in memory per clock tick accumulated 
in the current logon. 

Description of CCT (Job) 
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CCT contains the number of characters input and output for each job. 

Description of the TTYASG table: (Port) 

TTYASG contains the PACPTR for each job. From the PACPTR, the relabeling and 
other information can be found. 

Description of QO : 

QO is the beginning of the monitor queue tables. Each of the 5 queues 
(QTI, QIO, QSQ, QQC and QQE) have a 4 word array associated with it. 
The four word arrays have the following format: • 

First Word: If a job is on the queue, the first word contains the 

pacptr of the next job to run, otherwise, it contains 

the address of the table. 
Second Word: Contains the PACPTR of the first job on the Queue 
Third Word: Contains the address of the Queue Table 
Fourth V7ord: Contains the number of user on the Queue 

Description of the MONTAB table: 

Montab contains addresses the are only used for peeking. (Via BRS 127). 
The following is a list of current addresses: 

PNEXT Added to PACPTR to get next queue number 

PPTR Added to PACPTR to get previous PACPTR if in a chain. 
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BIT 


PO 





P1 


1 


P2 




P3 


3 


P4 


4 


P5 


5 


PG 


6 


P7 


7 
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SECTION 7.0 APPENDIX B 

* RANDOM FILES* 
DATE: 71/05/0 7 

DEFINITIONS : 

CP=CURSOR POSITION. THE ADDRESS OF THE NEXT CHARACTER, WORD OR 
BLOCK TO BE READ OR WRITTEN. THE LOWEST POSSIBLE CHARACTER ADDRESS 
IS 0. THE HIGHEST IS 14B6-1. 

CPTOP=ADDRESS OF HIGHEST LOCATION WRITTEN. 

OPENING RANDOM FILES: 

USE NORMAL OPEN FILE BRS ' S . THE HIGH ORDER BITS OF THE A 
REGISTER IN BRS 63 S 65 CONTAIN THE RANDOM FILE PRIVILEGE BITS. 
PRIVILEGE 

OPTION 


USER MAY EFFECTIVELY EXECUTE THE SCP SYSPOP. 


USER MAY ERASE INFORMATION FROM A FILE. (OUTPUT ONLY) 
USER MAY SET A FILE TO WRITE MODE. (OUTPUT ONLY) 
USER MAY SET A FILE TO READ MODE. 
IF ALL BITS ARE , THE SYSTEM WILL ALLOW ALL FOUR PRIVIELGES 
FOR NORMAL FILES. 

THIS IS TO ALLOW COMPATABILITY WITH PROGRAMS WRITTEN BEFORE 
RANDOM FILES. FOR READ ONLY FILES THE BRS WILL GIVE AN ERROR RETURN. 
FOR APPEND ONLY FILES ALL FOUR PRIVILEGES ARE DENIED AND THE 
CURSOR IS POSITIONED AT THE END OF THE FILE (CPTOP.) 

OPENING FILES TOR INPUT WITH BRS 62 £ 64 ALLOW READING AND 
SETTING OF CURSOR POSITIONS BUT PROHIBIT WRITING OR ERASING. 

CLOSING RANDOM FILES: 

USE NORMAL CLOSE FILE BRS'S. IF THE 

FILE IS CLOSED WHEN IN READ MODE, ALL THE FILE INFORMATION, INCLUDING 

UPDATES AND ERASURES, IS SAVED. 

FILE SYSPOPS: 

WIO - READ OR WRITE ONE WORD ON A FILE. 
CIO - READ OR WRITE ONE CHARACTER ON A FILE. 
BIO - READ OR WRITE A BLOCK OF WORDS ON A FILE. 
RCP - READ CURSOR POSITION 
SCP - SET CURSOR POSITION. 
PCE - POSITION CURSOR AND ERASE. 
SSP - SET PHYSICAL SIZE LIMIT. 

RSP - READ PHYSICAL SIZE, SIZE LIMIT AND ADDRESS OF HIGHEST 
LOCATION WRITTEN. 

FILE SIZE RESTRICTIONS: 

FILE DATA IS STORED ON THE DISC IN 1400B CHARACTER BLOCKS AND 

THE CURSOR POSITION ASSOCIATED WITH THE BEGINNING OF ANY DATA BLOCK 
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IS A MULTIPLE OF 1400B. THE MONITOR DOES NOT WRITE DATA BLOCKS 
THAT ARE ALL ZERO; HENCE, A FILE THAT COVERS A LARGE RANGE OF CURSOR 
POSITIONS MAY GRAB LESS DISC SPACE THAN A SMALL FILE THAT IS DENSELY 
PACKED WITH INFORMATION. EACH FILE HAS A MINIMUM OVERHEAD OF 1400B 
CHARACTERS TO MAP EACH FOUR PAGES OF NON-ZERO FILE DATA. THE DETAILS 
OF THE MAPPING OVERHEAD ARE COMPLICATED AND ARE A FUNCTION OF THE DATA. 

EACH FILE THAT IS OPENED FOR OUTPUT IS ASSIGNED A PHYSICAL 

FILE SIZE QUANTUM TO LIMIT THE AMOUNT OF ADDITIONAL DISC 

SPACE THAT THE USER MAY GRAB BEFORE CLOSING THE FILE. THIS 

QUANTUM, 1,364,000B CHARACTERS, IS REFRESHED EVERY TIME THE 

FILE IS OPENED UNLESS THE FILE SIZE INCLUDING OVERHEAD IS 3,145,727 CHAR, 

1,364,000B CHARACTERS ARE ABOUT EQUAL TO ABOUT 60D PAGES OF DATA. 

IF A FILE QUANTUM IS EXCEEDED, AN INSTRUCTION TRAP IS CAUSED. 

FILE FLAGS: 

WHEN ONE OF THE FOLLOWING CONDITIONS OCCUR, THE HIGH ORDER BITS OF 

THE FILE NUMBER ARE SET TO THE FOLLOWING: 

CONDITION FILE FLAG 

EOF 402B5 

ERROR 40 4B5 

QUANTUM OVERFLOW 410B5 
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SECTION 8.0 APPENDIX C 

*OP CODE FLAGS FOR TAPE BRS'S* 

DATE: 71/09/16 

OP CODE FLAGS FOR BRS ' S 102, 103, 105 AND 106: 

00= THE FOLLOWING RECORD WAS- READ OR WRITTEN CORRECTLY. 

01= FOLLOWING RECORD WAS IN ERROR. NO FURTHER TAPE COMMANDS WERE ISSUED. 

02= END OF FILE. NO MORE READING. THE PREVIOUS RECORD WAS THE LAST. 

03= LAST TAPE RECORD DUE TO LACK OF CORE SPACE. 

NO MORE RECORDS . FOLLOWING RECORD MAY HAVE BEEN TRUNCATED . 
04= FOLLOWING RECORD WAS TRUNCATED DUE TO OVER RUN OF 3 SEC. TIME LIMIT. 
05= NO MORE RECORDS DUE TO REACHING SPECIFIED RECORD COUNT. 

THE FOLLOWING RECORD IS THE LAST. 
06= END OF TAPE. NO MORE READING. THE PREVIOUS RECORD WAS THE LAST. 
07= PRINTER NOT READY OR TAPE NOT READY (»NO MORE READING) 
10= PAGE BOUNDARY ERROR ON WRITE. 
11= TAPE WRITE PROTECTED 
12= BEGINNING OF TAPE. NO WRITE. 
13= DEVICE NO LONGER ASSIGNED. 
14= "PANIC" 
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SECTION 9.0 APPENDIX D 

♦EXECUTIVE ERROR CODES* 

DATE: 71/10/01 

ERROR DESCRIPTION OF ERROR 
HO. 

NO PREVIOUS ERRORS REPORTED 

1 FILE BUSY - SOMEONE ELSE PROBABLY HAS THE FILE OPEN 

2 TOO MANY FILES OPEN 

3 FILE CANNOT BE WRITTEN NOW. DISK SPACE BEING PECLAIMED. 

4 INPUT-OUTPUT ERROR RECEIVED FROM DISC STORAGE UNIT 

5 FILE CANNOT BE WRITTEN NOW. DISK SPACE BEING RECLAIMED. 
9 SET CURSER POSITION ERROR ON APPEND ONLY r ILE 

10 FILE NAME NOT IN FILE DIRECTORY 

11 ILLEGAL POSITION IN FILE NAME OF A FILE NAME TERMINATING 
CHARACTER (GENERALLY BLANK, COMMA, OR SEMI-COLON) 

AS TIRST CHARACTER. 

12 UNEXPECTED END OF INPUT TILE NAME STRING. 

13 FILE NAME STRING POINTERS INVALID OR INDICATE MORE THAU 
75 CHARACTERS. 

14 NO FILE NAME PRECEEDING COMMENT PORTION (DASH) 

15 END OF FILE NAME STRING DISCOVERED IN PROTECTED PORTION 
OF STRING SUCH AS BETWEEN SLASHES 

1C CARRIAGE- RETURN FOUND IN PROTECTED PORTION OF TILE NAME STRING 

17 LINE-FEED TOUND IN PROTECTED PORTION OF FILE NAME STRING 

18 ADDITIONAL CHARACTER FOUND AFTER SECOND FULL QUOTE 
OF LIBRARY FILE NAME 

19 ILLEGAL CHARACTER IN UNPROTECTED PORTION OF FILE NAME 
USUALLY A PUNCTUATION MARK 

20 ILLEGAL CHARACTER TOUND IMMEDIATELY AFTER RIGHT- 
PARENTHESIS ON PUBLIC FILE. 

21 STRING ENDS ON PUBLIC FILE RIGHT PARENTHESIS 

22 FILE NAME AND COMMENT TOTAL MORE THAN 75 CHARACTERS. 

23 INVALID USER NAME USED WHEN ADDRESSING A PUBLIC FILE 

24 PROTECTED FILE (DECLARED NOT READABLE OR WRITABLE) 

25 OLD FILE OR NEW TILE MESSAGE NOT CONFIRMED WITH 
CARRIAGE- RETURN OR LINE-FEED 

2 6 ATTEMPT TO ADDRESS LIBRARY FILE FOR OUTPUT 

27 INVALID PARAMETER FOR BRS 16,19, ETC. (A REGISTER) 

2 FILE TYPE WRONG (USUALLY FOR TELETYPE) 

29 INVALID OR BAD FILE FOR OUTPUT (CHECK WITH DIRECTORY 
COMMAND) 

30 FILE DIRECTORY GROUP BECAME BUSY DURING OPERATION, RETRY 

31 GARBAGE GROUP POINTER IN FILE DIRECTORY. 

32 NUMBER OF FILES QUOTA EXCEEDED 

BY LOGGING OUT AND BACK IN, YOU WILL RECEIVE A NEW QUOTA. 

33 ATTEMPT TO OPEN "INIT" FILE FOR OUTPUT. 

34 FILE DIRECTORY GROUP CONFLICT BETWEEN TWO USERS, RETRY. 

35 INVALID PARAMETER FOR BRS 16,19, ETC. (A REGISTER) 

3 6 ATTEMPT TO OPEN PROPRIETARY FILE FOR INPUT. 
37 FILE NOT PRIVATE WRITABLE 
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38 FILE NOT PUBLIC WRITABLE 

39 FILE NOT PRIVATE READABLE 

40 NO INDEX BLOCK POINTER (NO DATA) IN FILE DIRECTORY 

41 INVALID OR BAD FILE FOR INPUT (CHECK WITH DIRECTORY 
COMMAND) 

42 LIBRARY FILE NAME USED ILLEGALLY 

43 YOU USED THE PUBLIC FILE OPTION ON A FILE THAT IS NOT PUBLIC 

44 UNEXPECTED ERROR FROM MONITOR ON FILE SYSPOPS 

45 FILE DECLARED READ ONLY 

46 GARBAGE IN FILE DIRECTORY 

47 ATTEMPT TO ADDRESS A FILE ACROSS ACCOUNT BOUNDARIES ILLEGALY 

48 FILE DIRECTORY NOT ACCOUNT SHARABLE 

50 INVALID PARAMETER FOR BRS 16,19, ETC. (A REGISTER) 

51 FILE DIRECTORY UNASSIONED. THE F.D. GROUP IS ALL ZEROS. 

52 END OF F.D. CHAIN WITHOUT FINDING FILE. 

53 FILE DIRECTORY GROUP BEING CHANGED BY ANOTHER USER. 

54 DUMP FILE MAY NOT BE CREATED BY USER PROGRAM. 

55 NO FILE TYPE SPECIFIED FOR OUTPUT FILE. 
MUST BE 1 TO 3 

61 FILE TYPE NOT "GO" 

62 ATTEMPT TO CALL PREMIUM CHARGE PROGRAM ILLEGALLY 

63 INVALID CONFIRMING CHARACTER 

64 EXEC COMMAND USED WITHOUT PROPER STATUS 

65 INIT FLAG ATTACHED TO FILE DIR. BUT NOT TO ANY FILE. 
RELEASE FLAG BY USING DEINIT COMMAND. 

67 SUB- SYSTEM NOT CURRENTLY AVAILABLE. 

68 NO SUB— SYSTEM OR GOTO PROGRAM IS CURRENTLY ASSIGNED TO YOU 

69 TROUBLE WITH FILE SUCH AS: FILE SICE DOES NOT AGREE WITH 
THE START AND END LOCATIONS OF THE GO FILE. (FILE EMPTY?) 

70 NO STARTING ADDRESS FOR GOTO PROGRAM 

71 DUMP FILE NOT COMPATIBLE WITH CURRENT SYSTEM 

72 APPARENT DISC ERROR 

73 INVALID SEPARATER BETWEEN PARAMETERS FOR AN EXEC COMJIAND 

74 INVALID PARAMETERS FOR AN EXEC COMMAND 

75 MUST BE LOGGED INTO DIRECTORY TO USE THIS COMMAND. 

76 UNABLE TO LOCATE A FILE AT THE SPECIFIED POSITION IN DIRECTORY 

77 IMPROPER RESPONSE. PROPER RESPONSES ARE: 

Y FOR YES, N FOR NO, CARRIAGE- RETURN OR LINE-FEED 

73 INVALID USER NAME USED MIEN ADDRESSING A PUBLIC TILE 

79 FILE DIRECTORY CONTROLS SET WRONG 

80 INSUFFICIENT USER MEMORY FOR MAIL 
USE RESET COMMAND AND RETRY 

31 FILE DIRECTORY CONTROLS SET WRONG 

82 INVALID SUB-SYSTEM NAME 

83 FILE TYPE T7RONG - NOT DUMP FILE 

84 FILE BUSY - SOMEONE ELSE PROBABLY HAS THE FILE OPEN 

85 FILE CANNOT BE WRITTEN NOW. DISK SPACE BEING RECLAIMED. 
89 MONITOR ERROR 
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SECTION 10.0 APPENDIX E 

♦FLOATING POINT* 

DATE: 71/09/16 

FLOATING POINT ARITHMETIC IS INCORPORATED INTO THE 940 SYSTEM THROUGH 
THE USE OF SYSPOPS. FLOATING POINT HARDWARE ('FPAU' = FLOATING POINT 
ARITHMETIC UNIT) IS AVAILABLE AS AN OPTION. CONDITIONAL ASSEMBLY OF 
THE MONITOR ALLOWS THE FLOATING POINT SYSPOPS TO UTILIZE THE FPAU OR 
TO USE SOFTWARE SIMULATION. THE COMPLETE DESCRIPTION OF EACH SYSPOP 
SHOULD BE CONSULTED TO DETERMINE SUITABILITY OF USE FOR A GIVEN 
APPLICATION. THREE SETS OF FLOATING POINT SYSPOPS ARE AVAILABLE: 

I. STANDARD SYSPOPS 

FLOATING POINT NUMBERS ARE NORMALIZED DOUBLEWORD VALUES. THE FIRST 
WORD IS A SIGN BIT FOLLOWED BY THE 23-BIT HIGH-ORDER PART OF THE 
MANTISSA; THE SECOND WORD CONSISTS OF THE 15 LOW-ORDER BITS OF THE 
MANTISSA FOLLOWED EY A 9-BIT EXPONENT. BOTH WORDS ARE TWO'S 
COMPLEMENT. THESE SYSPOPS REQUIRE THAT THE RESULT OF ANY OPERATION 
BE RETURNED IN THE A AND B REGISTERS. ir THE FPAU IS IMPLEMENTED, 
THE CURRENT CONTENTS OF THE A AND B REGISTERS ARE OUTPUT TO THE 
FPAU, THE OPERATION PERFORMED, AND THE RESULT COPIED TO THE A AND B 
REGISTERS. THE FOLLOWING SYSPOPS ARE IMPLEMENTED: 

FAD FLOATING ADD 

FSB FLOATING SUBTRACT 

FMP FLOATING MULTIPLY 

FDV FLOATING DIVIDE 

BRS 21 FLOATING NEGATE 

BRS 50 FIX A £ B TO A-REGISTER 

BRS 51 FLOAT A-REGISTER TO A S B 

LDP LOAD DOUBLEWORD (FPAU NOT AFFECTED) 

STP STORE DOUBLEWORD (FPAU NOT AFFECTED) 



II. FPAU SYSPOPS 

THESE SYSPOPS ARE INCLUDED FOR USE WITH THE TPAU IF IT IS NOT 
NECESSARY TO HAVE THE RESULT OF EACH OPERATION RETURNED IN 
THE A 6 B REGISTERS THEREBY PROVIDING A TIME SAVING DURING 
SUCCESSIVE FLOATING POINT OPERATIONS. ALL OF THESE SYSPOPS 
PERFORM THE OPERATION WITH THE CURRENT CONTENTS OF THE FPAU AND 
LEAVE THE RESULT IN THE FPAU. FOR COMPATIBILITY, THESE SYSPOPS 
ARE ALSO OPERATIVE IF THE FPAU IS NOT IMPLEMENTED, IN WHICH 
CASE THEY BEHAVE IDENTICALLY TO THE STANDARD SYSPOPS WITH THE 
EXCEPTION THAT THE FLOATING POINT ACCUMULATOR IS SIMULATED BY 
THE MONITOR. THE FORMAT OF THE FLOATING POINT WORD IS THE SAME 
AS FOR THE STANDARD SYSPOPS. THE FPAU SYSPOPS INCLUDE: 



FrAD 


FLOATING 


ADD 


rr sb 


FLOATING 


SUBTRACT 


FFSI 


FLOATING 


SUBTRACT 



INVERSE 
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FFMP 

FFDV 

FFDI 

LDrM 

STFM 

BRS 82 

BRS 

BRS 

BRS 

BRS 

BRS 

BRS 

BRS 



83 

84 

118 

119 

148 

149 

150 



FLOATING MULTIPLY 

FLOATING DIVIDE 

FLOATING DIVIDE INVERSE 

LOAD FLOATING ACCUMULATOR 

STORE FLOATING ACCUMULATOR 

SKIP IF FLOATING ACCUMULATOR NEGATIVE 

SKIP IF FLOATING ACCUMULATOR = 

SKIP IF FLOATING ACCUMULATOR # 

COPY A £ B TO FLOATING ACCUMULATOR 

COPY FLOATING ACCUMULATOR TO A £ B 

NEGATE FLOATING ACCUMULATOR 

FIX FLOATING ACCUMULATOR TO A-REGISTER 

FLOAT A-REGISTER TO FLOATING ACCUMULATOR 



III. FORTRAN II SYSPOPS 

THESE SYSPOPS ARE FOR USE WITH FORTRAN £1 COMPATIBLE PROGRAMS. 
THESE SYSPOPS REQUIRE THAT THE FIRST FLOATING POINT WORD CONSIST 
OF THE 15 LOW-ORDER BITS OF THE MANTISSA FOLLOWED BY A 9-BIT 
EXPONENT WHILE THE SECOND WORD CONTAINS A SIGN BIT FOLLOWED BY THE 
23 HIGH-ORDER BITS OF THE MANTISSA. FOR EASE IN HANDLING ARRAY 
VARIABLES, THESE POPS DOUBLE THE CONTENTS OF THE X- REGISTER BEFORE 
PERFORMING THE EFFECTIVE ADDRESS CALCULATION, AND THEN RESTORE THE 
INITIAL VALUE OF THE X- REGISTER. THE FOLLOWING SYSPOPS UTILIZE 
THE FPAU AND THE A £ B REGISTERS: 



FFADD 


FORTRAN 


FLOATING ADD 


FFSBD 


FORTRAN 


FLOATING SUBTRACT 


FFSID 


FORTRAN 


FLOATING SUBTRACT INVERSE 


FFMPD 


FORTRAN 


FLOATING MULTIPLY 


FFDVD 


FORTRAN 


FLOATING DIVIDE 


FFDID 


FORTRAN 


FLOATING DIVIDE INVERSE 


LDFMD 


FORTRAN 


LOAD FLOATING 


STFMD 


FORTRAN 


STORE FLOATING 



IV. FOS POPS 



FOS FLOATING POINT NUMBERS HAVE THE SAME FORMAT AS FOR THE FORTRAN 
II SYSPOPS. THE FOLLOWING POPS ARE DEFINED IN AND USED BY FOS, 
LIB, PLIB, FSUBR, ETC. AND ARE INCLUDED HERE FOR REFERENCE BY USERS 
WHO WRITE ASSEMBLY LANGUAGE ROUTINES FOR FOS. THE POP DEFINITIONS 
GIVEN ARE FOR ARPAS; FOR NARP, SUBSTITUTE ",2" FOR ",1,1" 
AND ",1,1" FOR " ,2" . POPS MARKED BY A "*" DOUBLE THE CONTENTS OF 
THE X-REGISTER BEFORE COMPUTING THE EFFECTIVE ADDRESS: 



FST 
STD 
LDP 
FTA 
FTS 
FTM 
FTD 
XST 
LTF 



105B5,1 , 
107B5,1, 
125B5,1, 
126B5,1, 
132B5,1, 
136B5,1, 
142B5,1, 
104B5,1, 
122B5,1, 



FLOATS A, STORES IN MEMORY 

STORES A£B IN MEMORY 

LOADS A£B FROM MEMORY 

FLOATS INTEGER IN MEMORY, ADDS TO A£E 

FLOATS INTEGER IN MEMORY, SUBS FROM A£B 

FLOATS INTEGER IN MEMORY, MUL BY A£B 

FLOATS INTEGER IN MEMORY, DIV A£B BY IT 

FIXES A£B AND STORES IN MEMORY 

FLOATS INTEGER IN MEMORY TO A£B 
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* 


LTX 


123B5,1,1 


FIXES ASB FROM MEf 


* 


PL?. 


131B5, 1,1 


FLOATING ADD 


* 


FLS 


13535,1,1 


FLOATING SUBTRACT 


* 


FLM 


141B5,1 ,1 


FLOATING MULTIPLY 


* 


FLD 


145B5,1, 1 


FLOATING DIVIDE 




FLU 


147B5,2 


FLOATING NEGATE OF 



ASB 



V. FLOATING POINT OVERFLOW 

IF THE FLOATING POINT OPERATIONS ARE SOFTUARE SIMULATED, EXPONENT 
OVERFLOW WILL CAUSE THE CPU OVERFLOW INDICATOR TO BE SET. IF 
THE INDICATOR IS SET BY A FLOATING POINT OPERATION, IT WILL REMAIN 
SET UNTIL THE USER EXECUTES THE 'OVT* INSTRUCTION. 

IF THE FLOATING POINT ARITHMETIC UNIT IS IMPLEMENTED, EXPONENT 
•OVERFLOW WILL CAUSE THE OVERFLOW INDICATOR IN THE FPAU TO BE SET. 
THE SETTING OF THE INDICATOR FORCES AN INTERRUPT TO OCCUR. THE 
INTERRUPT ROUTINE WILL RESET THE FPAU OVERFLOW INDICATOR, SET 
A FLAG THAT INDICATES THAT OVERFLOW OCCURRED, AND ARM THE 
MONITOR-TO-USER TRANSITION TRAP. WHEN THE TRANSITION TRAP IS 
ENTERED, THE OVERFLOW FLAG IS EXAMINED. IF TEE FLAG IS SET, 
THE CPU OVERFLOW INDICATOR IS SET AND SOFTWARE INTERRUPT 6, 
IE ARMED, WILL BE TRIGGERED. IF THE SOFTWARE INTERRUPT IS NOT 
ARMED, A RETURN TO THE USER PROGRAM WILL OCCUR. THE USER 
CAN ISSUE THE 'OVT' INSTRUCTION TO TEST FOR OVERFLOW AND 
RESET THE CPU OVERFLOW INDICATOR. 

VI. INPUT/OUTPUT AND CONVERSION OF FLOATING POINT NUMBERS 

BRS 52 AND BRS 53 CAN BE USED FOR THE INPUT/OUTPUT OF FLOATING- 
POINT NUMBERS TO A TILE. 30TK THESE BBS'S REQUIRE A FORMAT WORD 
IN THE X-REGISTER. THE SIC AND ISC SYSPOPS PERFORM STRING TO 
FLOATING POINT AND FLOATING POINT TO STRING CONVERSIONS, 
RESPECTIVELY; THEY ALSO REQUIPE A FORMAT WORD IN THE X-REGISTER. 
THE DESCRIPTION OF THE FORMAT WORD FOLLOWS THE DESCRIPTION 
OF THE ERROR CODES FOP THESE ROUTINES. THE FLOATING POINT NUMBER 
USED BY THE ROUTINES IS THE SAME AS FOR THE STANDARD FLOATING 
POINT ARITHMETIC SYSPOPS. 

"STRING" TO FLOATING POINT CONVERSION: 

THE D FIELD IS OVERRIDDEN BY THE PRESENCE Or A DECIMAL POINT. 
IF A DECIMAL POINT AND/OR E ARE PRESENT, ANY FORM OF A NUMBER 
IS ACCEPTABLE TO ANY INPUT FORMAT. ILLEGAL CHARACTERS APPEARING 
ANYWHERE IN THE FIELD MAY BE IGNORED BY SETTING BIT 19 IN THE 
FORMAT WORD. ALL BLANKS WILL BE CONVERTED TO ZERO. FREE FORM 
INPUT WILL ACCEPT CHARACTERS UNTIL A TERMINATING CHARACTER 
( ANY CHARACTER EXCEPT + - . E OR DIGIT ) IS INPUT. THE MAX If <UM 
ALLOWABLE INPUT DIGITS =12. IF MORE THAN 12 ARE USED, THE MOST 
SIGNIFICANT 12 WILL BE USED. INSIGNIFICANT LEADING OR TRAILING 
ZEROES WILL BE IGNORED. 
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FLOATING POINT TO "STRING" CONVERSION: 

CONVERSION REQUIRES A FLOATING POINT NUMBER IN A£B (THE MOST 
SIGNIFICANT FRACTIONAL PART IN A AND THE LEAST SIGNIFICANT 
FRACTIONAL PART AND EXPONENT IN B) . IF FREE FORM OUTPUT 
IS USED, THE NUMBER WILL BE OUTPUT IN F16 FORMAT WITH 5 LEADING 
SPACES IF THE EXPONENT IS LESS THAN 37B. FOR LARGER EXPONENT 
VALUES, E16.9 FORMAT IS USED. 

THE ISC AND SIC SYSPOPS FUNCTION SIMILARLY TO THE BRS 52 AND 
BPS 53 EXCEPT THE FILE NUMBER BITS MUST BE SET TO ZERO. 

ERROR CONDITIONS 

X = NO ERROR WAS DETECTED 

X = 1 NUMBER OF DECIMAL DIGITS AFTER THE DECIMAL POINT 

EXCEEDS 12 ON FORMATTED INPUT 
X = 2 FIELD TOO SHORT FOR E FORMAT ON OUTPUT 

ACTION WILL BE TAKEN DEPENDING ON THE 

IN THE FORMAT WORD 
X = 3 INPUT NUMBER EXCEEDS THE MAXIMUM ALLOWABLE BOUNDS 
X = 4 FIELD TOO SHORT FOR F OR I FORMAT ON OUTPUT. OVERFLOW 

ACTION WILL BE TAKEN DEPENDING ON THE VALUE OF BIT 15 

OF THE FORMAT WORD 
X = 5 AN E rORMAT WAS SPECIFIED FOP INPUT BUT 

STRING DOES HOT CONTAIN AN 'E 1 OR '.'. 

WILL BE CONCERTED USING AN EQUIVALENT F 
X = 6 AN ILLEGAL CHARACTER WAS ENCOUNTERED IN 



?. OVERFLOW 
VALUE OF BI*: 



THE INPUT 
THE NUMBER 
FORMAT 
THE INPUT 



cr"2\?T 



FORMAT WORD DESCRIPTION 



BIT! 



0- 2 



FORMAT TYPE 



(ILLEGAL) 

1 INTEGER (I FORMAT) 

2 E FORMAT WITH NUMBER RIGHT- JUSTIFIED IN FIELD 

3 F FORMAT WITH NUMBER RIGHT-JUSTIFIED IN FIELD 

4 E FORMAT WITH NUMBER LEFT-JUSTIFIED IN FIELD 

5 F FORMAT WITH NUMBER LEFT- JUSTIFIED IN FIELD 

6 (ILLEGAL) 

7 (ILLEGAL) 



BIT! 



3- 8 



NUMBER OF DIGITS FOLLOWING TEE DECIMAL POINT 



BITS 9-14 



BIT 1 5 



TOT/vL FIELD WIDTH. IF = , FREE-FORM. INPUT/OUTPU 
IN A FIELD WIDTH OF 16 WILL BE PERFORMED 
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OVERFLOW ACTION. IF THE FIELD WIDTH IS TOO SMALL ON 
OUTPUT AND THIS BIT IS SET, THE FIRST CHARACTER Or THE 
OUTPUT FIELD WILL BE AN ASTERISK. IF THIS BIT IS 
RESET AND FIELD WIDTH OVERFLOW OCCURS, CHARACTERS ON THE 
RIGHT WILL BE LOST. 

BITS 16-23 

FILE NUMBER TO BE USED WITH BRS 52 AND BRS 53 

EXAMPLES OF THE USE OF THE FORMAT WORD: 

ASSUME THAT THE A SB REGISTERS CONTAIN THE VALUE TOR 
FLOATING POINT 123.5 USING BRS 53: 



X- REGISTER 

30105 

30206 

00000 

30210 

30207 

20514 

40514 



OUTPUT 



123. 5 1 
1 *-* ° 50 ' 

123.5000000' 
123.50' 
123.50' 
1.23500E+02' 
1.23500E+02 ' 
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SECTION 11.0 APPENDIX F 

♦MACHINE LANGUAGE SUBROUTINES* 

DATE: 71/09/16 

SOME USER PROGRAMS MAY REQUIRE THE COPYING OF A DISC FILE. THE 
FOLLOWING RECOMMENEDED PROCEDURE IS FASTER THAT A CIO LOOP. IF THE 
(FILE SIZE) MOD 3 IS NON ZERO, A BIO WILL INTRODUCE EXTRANEOUS BLANKS 
IN THE LAST WORD OF THE FILE. THE FOLLOWING ROUTINE ELIMINATES 
THAT POSSIBILITY: 

LENGTH EQU 100 00B LENGTH OF FILE BUFFER (CAN BE CHANGED) 
COPY RCP OUTFIL; MRG =4B7; SCP OUTFIL; HLT (ERROR, TRAP) 

RSP INFIL; STA SIZE 
COPYA LDA =LENGTH; LDX =BUFFER; BIO INFIL; BRU EOF 

LDA =LENGTH; LDX =BUFFER; BIO OUTFIL; NOP; BRU COPYA 
EOF SUB =BUFFER; LDX =BUFFER; SKE =0; Bio OUTFIL; NOP 

RSP OUTFIL; XMA SIZE; MRG =4B7; SCP OUTFIL; HLT; LDA SIZE 

PCE OUTFIL; NOP; BRS 147 

SIZE ZRO O SIZE OF FILE 
INFIL ZRO INPUT FILE NUMBER 
OUTFIL ZRO O OUTPUT FILE NUMBER 
BUFFER BSS LENGTH TRANSFER BUFFER 

WHEN OPENING A FILE, AN ERROR MAY OCCUR AND THE EXEC MAY NOT TYPE AN 
ERROR MESSAGE. THE FOLLOWING ROUTINE WILL TAKE THE ERROR NUMBER 
ND PRINT THE ERROR MESSAGE. (SEE APPENDIX D) 

WHY LDP WHVPTR; BRS 64; BRS 10 (NOT THERE); STA WIIYFIL 

BRS 73 (READ ERCODE) ; SKA =32B5 (MONITOR ERROR?); BRS 10 
MUL =3; LSH 23; ADD =21; SCP WIIYFIL; HLT; WIO WHYFIL; SUB =235B 
MUL =3; LSH 23; SCP WHYFIL; HLT 
LOOP CIO WHYFIL; SKE = • /'; BRU TYPE; BRS 10 
TYPE SKE = ' $»; BRU *+2; LDA =155B; CIO =1; BRU LOOP 

WHYFIL ZRO WHY FILE NUMBER 

WHYPTR DATA (R)WHYSTR-1 , (R) WKYSTR+3 USE THIS IN ARPAS AND 
WHYPTR DATA 3*WKYSTR-1 , 3*WHYSTR+3 THIS IN NARP. 
WHYSTR ASC ' *WHY ■ 

ANOTHER APPROACH TO THE SAME SITUATION IS TO USE THE EXECUTE 
EXEC COMMAND BRS AS THE FOLLOWING: 

WHY LDA = , i-7HY l ; MRG = 4B7; BRS 142; ... 

WHEN TRANSMITTING FILES, IT IS USEFUL TO HAVE A CHECKSUM TO COMPARE 
WITH THE ORIGINAL. THE FOLLOWING ROUTINE WILL PRINT OUT THE CHECKSUM 
FOR THE INPUT FILE: 

CHECK WIO INFIL; SKIT INFIL; BRU *+2; BRU END; STA WIOSUM 
LDA CKKSUM; CLB; LCY 7; ADD WIOSUM; STB CIIKSUM 
ADM CHKSUM; BRU CHECK 
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END LDA CHKSUM; LDB =3; LDX =1 ; BRS 36; BRS 10 

IMFIL ZRQ FILE TO BE CHECKSUMED TILE NUMBER 
WIOSUM ZRO TEMPORARY FOR INPUT FROM 171 
CHKSUM ZRO FILE CHECKSUM 
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SECTION 12.0 APPENDIX G 

*ALL ABOUT PMT ' S AND SMT'S* 

DATE: 71/03/29 

PSEUDO RELABELING IS A MECHANISM WHEREBY A MACHINE 
LANGUAGE PROGRAM CAN ACCESS MORE STORAGE THAN 1 6K WORDS 
WITHOUT USING THE DISK. 

A PAGE IS A UNIT OF INFORMATION COMPRISED OF 2048 WORDS. 
A PAGE IS SOMETIMES IN CORE, SOMETIMES ON THE DRUM (RAD) AND 
SOMETIMES ON BOTH AT ONCE. WHEN A USER PROGRAM IS RUNNING, IT HAS 
ACCESS TO EIGHT PAGES OR LESS. A BRS 43 TELLS A USER MUCH OF THE 
USER'S POSSIBLE EIGHT PAGES ARE IN USE, AND FOR THOSE IN USE IT GIVES 
A PAGE NAME WHICH CAN BE USED WITH OTHER BRS'S. WHEN A PROGRAM LOADS 
OR STORES AT AN ADDRESS WHICH DOESN'T CORRESPOND TO A PAGE, THE 
PROGRAM IS TRAPPED AND RESTARTED LATER WITH A NEW REAL PAGE AT THAT 
ADDRESS. IF ALL 33 OCTAL PAGES ARE IN USE, A MEMORY TRAP RESULTS. 
A BRS 44 DIRECTS THE MONITOR TO PLACE PAGES AT THE SPECIFIED 
ADDRESSES IN THE USER'S PROGRAM . THESE PAGES ARE NAMED WITH THE NAMES 
GIVEN BY THE MONITOR IN PREVIOUS BRS 43 'S OR BRS 3'S. THE BRS 3 IS 
USED TO POINT TO A SUBSYSTEM BYTE. UNLESS THE FORK HAS EXEC STATUS 
THE BYTE MUST BE READ ONLY. IF TEE BYTE HAS BEEN MADE VISIBLE TO 
USERS, IT MAY BE RELABELED IN WITHOUT STATUS. THE FOLLOWING IS 
LIST OF HOW NOT TO OBTAIN MORE MEMORY: 

FALLING THROUGH A PAGE. (GOING OVER A PAGE BOUND RY) 

LOADING/STORING INDIRECT THROUGH AN OUT OF BOUNDS ADDRESS 

DOING A EXU TO AN OUT OF BOUNDS ADDRESS 

EXECUTING A POP IF PAGE IS NOT IN 

DOING A BRS 44 OR 117 REQUESTING A NON ACQUIRED BYTE NUMBER. 

EXECUTING A BRS 9 AND USING ILLEGAL RELABELING BYTES 

THERE ARE SOME PAGES THAT ARE IN EXISTENCE BEFORE THE 

JOB COMES INTO EXISTENCE. THEY CONTAIN INFORMATION TEAT IS 

COMMONLY USED BY MANY JOBS. MOST OF THESE PAGES HOLD PROPREITARY 

INFORMATION. THEY HAVE NUMBERS LESS THAN 43 AND ARE KNOWN 

AS SMT'S, FOR "SHARED MEMORY" INSTEAD OF "PRIVATE MEMORY". 



1) 
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SECTION 13.0 APPENDIX H 

♦TYMNET* 
DATE: 71/09/22 
THE TYHNET APPENDIX HAS NOT BEEN WRITTEN YET. PLEASE WAIT PATIENTLY, 
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SECTION 14.0 APPENDIX I 

♦FORKING* 
DATE: 71/09/22 

Sometimes programs need to control other programs. 

The primary mechanism provided by the operating system 

for this purpose is the fork. In the Tymshare system a fork 

is very much like a subroutine. The initiating fork is called the 

upper fork. It plays the role of the caller of a subroutine. 

The initiated fork is called the lower fork. It is anologous 

to the subroutine. The memor}' of different forks may be comprised 

of different pages. The upper fork controls the pages that the lower 

fork starts with. The upper fork may limit the degree of control 

that a lower fork has of the escape (alt-mode) mechanism. With 

the absolute memory bit the upper fork ca,n prevent the lower fork 

from getting access to any other pages than it was stated with. 

with the local memory bit the upper fork causes references 

by the lower fork to absent pages to get new pages. Otherwise 

the page with the coresponding address in the upper fork would be used. 

At one time one fori: has control over the escape key. 
The upper fork may delegate this control to a lower fork 
when it starts it by bit 2 in the accumulator argument to the 
BRS 9. This is called "propogating the escape". 
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SECTION 15.0 APPENDIX J 

♦INDEX BY BRS FUNCTION* 

DATE: 71/10/01 

INDEX BRS NO.S 

110 BAUD BRS 132 

1 50 BAUD . BRS 1 32 

211B BRS 153, 154 

300 BAUD BRS 132 

ANSWER BRS 1 59 

AUXILARY CIRCUIT BRS 133, 139 

AUXILARY CIRCUITS BRS 1 56 

BCD BRS 107 

BIT rap BRS 25, 30, 54 

CHARACTER GOBBLER BRS 11, 29 

CLOSE BRS 2, 8, 17, 20, 147 

COMMAND FILE BRS 1 7 

COMMAND PORT BRS 12, 29 , 132, 

CONTROL PARAMETER. 170 RD BRS 39 

CONVERSION BRS 50 , 51 

CPU ERS 88 

DATA BLOCK BRS 41 

DATE BRS 9 1 

DELETE BRS 69 

DENSITY BRS 108 

DISMISS BRS 14, 45, 72 

ECHO BRS 1 2 

ECHO TABLE BRS 12, 40 

EIGHT-LEVEL BRS 85 , 86 

ERCODE BRS 73 

EXEC STATUS BRS 9 

EXPANDED SMT BRS 3 , 57 

FATAL EXCEPTION BRS 1 

FILE BRS 1, 2, 8, 15, 16, 18, 19, 20, 37, 48 

58, 62, 63, 64, 65, 66 , 68, 69, 147 

FILE /^TRIBUTES ■ BRS 96 

FILE DIRECTORY BRS 15, 48, 60, 63, 96 

FILE DIRECTORY POINTER ADDRESS.. BRS 1, 6, 37 

FILE NAME BRS 60 

FILE NUMBER BRS 33, 34, 35, 36, 33 

FILE PARAMETERS BRS 6 

FILE SIZE QUANTUM BRS 92 

FILES BRS 1 7 

FIXED MEMORY BRS 9 

FLOATING ACCUMULATOR BRS 82 , 83 , 34 

FLOATING POINT BRS 21, 50 , 51 

FORE BPS 5, 9, 10, 31 

FORMAT BRS 52 , 53 

INDEX BLOCK BRS 1 57 

INDIRECT PO UTTER BRS 3 

INPUT BRS 62, 64 
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INPUT BUFFER BRS 11, 13 

INPUT PORT BRS 139, 155 

INTERRUPT BRS 135 

INTERRUPTS BRS 49 

KILL BRS 4 

LEVEL 3 BRS 1 57 

LOCAL MEMORY BRS 9 

LOOKUP BRS 15, 18, 48 

LOWER FORK BRS 9 

MAG TAPE BRS 102, 103, 105, 107, 108, 110 

MESSAGE BRS 34 

MONITOR TABLES BRS 7 

MUD . BRS 1 38 

N/(2**A) BRS 132 

NON-TERMINABILITY BRS 46 , 47 

NUMBER BRS 36, 38 

OFF INTERRUPT BRS 26 

OPEN BRS 1, 16, 19, 62, 63, 64, 65 

OUTPUT BRS 63 , 65 

OUTPUT BACKPRESSURE BRS 1 4 

OUTPUT BUFFER BRS 14, 29, 164 

OUTPUT PORT BRS 1 55 

OVER FLOU GROUPS BRS 95 

PAC BRS 9 

PAGES BRS 70 

PANIC BRS 9 , 26 , 90 

PANIC ASSIGNMENT BRS 9 

PANIC TABLE BRS 9 , 31 

PAPER TAPE MODE s s s s s s s s s , s e BRS 134 

PARITY BRS 1 07 

PHANTOM USER BRS 26 

PMT BRS 56 

PORT BRS 138, 155 

PORT NUMBER BRS 87 

PORT NUMBERS BRS 1 37 

PREMIUM CHARGE BRS 170, 171 

PRINTER BRS 1 06 

RANDOM I/O BRS 63 

READ ONLY BRS 80 

RECOVER BRS 56 

RELABELING BRS 3, 43, 44 

RENAME BRS 37 , 58 

RESOURCE METERING BRS 89 

ROYALTY UNITS BRS 1 58 

SHIFT CONTROL O BRS 168, 169 

SOFTWARE INTERRUPT BRS 78 

STATISTICS... BRS 27, 28 

STRING BRS 33, 35 

STRING POINTER BRS 33 

SUBSYSTEM BYTE NUMBER BRS 3 

SUBSYSTEM STATUS BRS 9 

SUPERVISOR BRS 138, 153, 154, 

SYSTEM STATUS BRS 9 

TERMINAL BRS 1 2 
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TERMINAL CHARACTERISTICS BRS 132 , 160 

TERMINATE BRS 10, 31, 90 

TIME BRS 91, 135 

TOUT BRS 17, 77 

TRAP BRS 9 

TS PAGE BRS 6 7 

TYMNET BRS 172 

UNIVERSAL USER NUMBER BRS 39 

USER NAME BRS 59 

YELLOW BALL . BRS 164 

ZAP BRS 139, 156 
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